Merge branch 'main' into synth-browser-alert-config

.github/ISSUE_TEMPLATE/0-community-request.yaml → .github/ISSUE_TEMPLATE/community-request.yaml

@@ -1,13 +1,14 @@
-name: "[Community] Documentation request"
+name: "Community documentation request"
 description: Request a documentation change or enhancement.
-title: "[REQUEST]: "
-labels: ["request", "Team:Docs", "💝 community"]
+title: "[Request]: "
+labels: ["Request", "💝 community"]
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to fill out this request! This form will create an issue that the obs-docs team will triage and prioritize.
-        Want to submit a PR instead? Most of our public documentation has an "edit" icon—just give it a click to quickly find any source file.
+        Hi 👋. Thanks for taking the time to fill out this request!
+        This form will create an issue that Elastic's Observability docs team will triage and prioritize.
+        Want to open a PR instead? Most of our public documentation has an "edit" icon—just give it a click to quickly find any source file.
   - type: textarea
     id: link
     attributes:
@@ -28,4 +29,4 @@ body:
       label: Additional info
       description: Anything else we should know?
     validations:
-      required: false
+      required: false

.github/ISSUE_TEMPLATE/elastic-request.yaml

@@ -0,0 +1,94 @@
+name: "Internal documentation request (Elastic employees)"
+description: Request a documentation change or enhancement.
+title: "[Request]: "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Hi 👋. This form will create an issue that the [@elastic/obs-docs](https://github.com/orgs/elastic/teams/obs-docs) team will triage and prioritize. Please do not add any labels to your issue—that will happen automagically.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe what needs to be documented. What details do users need to know about?
+      placeholder: |
+        What: We're introducing new feature A.
+        When: This feature will launch at the completion of project B.
+        Why: This feature will make X, Y, and Z easier for the user.
+    validations:
+      required: true
+  - type: textarea
+    id: related
+    attributes:
+      label: Resources
+      description: Where can the documentation team learn more about this feature?
+      placeholder: |
+        This feature was implemented in {link_to_PR}.
+
+        This feature was scoped and researched in {link_to_issue}.
+    validations:
+      required: true
+  - type: dropdown
+    id: doc-set
+    attributes:
+      label: Which documentation set does this change impact?
+      description: Stateful, Serverless, or both?
+      options:
+        - Stateful and Serverless
+        - Stateful only
+        - Serverless only
+        - Integrations
+        - Unknown
+      default: 0
+    validations:
+      required: true
+  - type: textarea
+    id: doc-set-differences
+    attributes:
+      label: Feature differences
+      description: If you selected both Stateful and Serverless above, please describe how, if at all, the feature differs in each deployment method.
+      placeholder: The feature is identical in Stateful and Serverless.
+    validations:
+      required: true
+  - type: dropdown
+    id: version
+    attributes:
+      label: What release is this request related to?
+      description: Some requests may be tied to the Elastic Stack release schedule. Some, like Serverless requests, may not. Please select an option.
+      options:
+        - 'N/A'
+        - '8.11'
+        - '8.12'
+        - '8.13'
+        - '8.14'
+        - '8.15'
+        - '8.16'
+      default: 0
+    validations:
+      required: true
+  - type: dropdown
+    id: collaboration
+    attributes:
+      label: Collaboration model
+      description: Which team do you expect to create the initial content?
+      options:
+        - "The documentation team"
+        - "The product team"
+        - "The engineering team"
+        - "Unknown"
+        - "Other (please describe below)"
+      default: 0
+    validations:
+      required: true
+  - type: textarea
+    id: contact
+    attributes:
+      label: Point of contact.
+      description: Please assign at least one point of contact using the GitHub `@` mention. Add as many stakeholders as you'd like.
+      value: "**Main contact:** @\n\n**Stakeholders:**\n"
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for filling out this form. Note that this form does not guarantee that your issue will be prioritized for the selected iteration. _But_, completing this issue as early and as comprehensively as possible will help us understand and plan the work better!

.github/advanced-issue-labeler.yml

@@ -0,0 +1,44 @@
+policy:
+  - template: ['elastic-request.yaml']
+    section:
+      - id: ['version']
+        block-list: []
+        label:
+          - name: 'Request'
+            keys: ['N/A']
+          - name: 'Request:8.11'
+            keys: ['8.11']
+          - name: 'Request:8.12'
+            keys: ['8.12']
+          - name: 'Request:8.13'
+            keys: ['8.13']
+          - name: 'Request:8.14'
+            keys: ['8.14']
+          - name: 'Request:8.15'
+            keys: ['8.15']
+          - name: 'Request:8.16'
+            keys: ['8.16']
+      - id: [doc-set]
+        block-list: []
+        label:
+          - name: 'Docset:All'
+            keys: ['Stateful and Serverless']
+          - name: 'Docset:Serverless'
+            keys: ['Serverless only']
+          - name: 'Docset:Stateful'
+            keys: ['Stateful only']
+          - name: 'Docset:Integrations'
+            keys: ['Integrations']
+          - name: 'Docset:Unknown'
+            keys: ['Unknown']
+      - id: [collaboration]
+        block-list: []
+        label:
+          - name: 'Lead:Writer'
+            keys: ['The documentation team']
+          - name: 'Lead:Product'
+            keys: ['The product team']
+          - name: 'Lead:Eng'
+            keys: ['The engineering team']
+          - name: 'Lead:Unknown'
+            keys: ['Unknown', 'Other (please describe below)']

.github/workflows/add-issue-to-project.yml

@@ -30,4 +30,4 @@ jobs:
           contentid: ${{ github.event.issue.node_id }}
         env:
           PROJECT_ID: "PVT_kwDOAGc3Zs0iZw"
-          GITHUB_TOKEN: ${{ steps.get_token.outputs.app_token }}
+          GITHUB_TOKEN: ${{ steps.get_token.outputs.app_token }}

.github/workflows/issue-labeler.yml

@@ -0,0 +1,32 @@
+name: Issue labeler
+on:
+  issues:
+    types: [ opened ]
+
+permissions:
+  contents: read
+
+jobs:
+  label-component:
+    runs-on: ubuntu-latest
+
+    permissions:
+      issues: write
+      actions: read
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Parse issue form
+        uses: stefanbuck/github-issue-parser@v3
+        id: issue-parser
+        with:
+          template-path: .github/ISSUE_TEMPLATE/elastic-request.yaml
+
+      - name: Set labels based on issue field
+        uses: redhat-plumbers-in-action/advanced-issue-labeler@v2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-form: ${{ steps.issue-parser.outputs.jsonString }}
+          template: elastic-request.yaml

docs/en/observability/create-observability-connectors.asciidoc

@@ -28,7 +28,7 @@ automatically close when they are sent to an external system.
 +
 --
 [role="screenshot"]
-image::images/add-case-connector.png[]
+image::images/cases-settings.png[View case settings]
 // NOTE: This is an autogenerated screenshot. Do not edit it directly.
 --
 . From the *Incident management system* list, select *Add new connector*.

docs/en/observability/grant-cases-access.asciidoc

@@ -12,7 +12,7 @@ Here are the minimum required privileges:
 |=== 
 
 | Action | {kib} Privileges
-| Give full access to manage cases 
+| Give full access to manage cases and settings
 a|
 * `All` for the *Cases* feature under *{observability}*.
 * `All` for the *{connectors-feature}* feature under *Management*.

docs/en/observability/index.asciidoc

@@ -18,8 +18,7 @@ include::observability-get-started.asciidoc[leveloffset=+1]
 
 include::logs-metrics-get-started.asciidoc[leveloffset=+2]
 
-//TOOD: Rename this file to traces-get-started in a follow-on PR
-include::ingest-traces.asciidoc[leveloffset=+2]
+include::traces-get-started.asciidoc[leveloffset=+2]
 
 include::splunk-get-started.asciidoc[leveloffset=+2]
 

docs/en/observability/landing-page/data/recommended-data.json

@@ -11,8 +11,8 @@
         {
           "title": "Monitor your application performance",
           "description": "Learn how to collect and visualize Application Performance Monitoring (APM) data with the Elastic Stack.",
-          "link": "ingest-traces.html",
-          "image": "ingest-traces.png"
+          "link": "traces-get-started.html",
+          "image": "traces-get-started.png"
         },
         {
           "title": "Monitor your application logs",