Merge branch 'main' into alerting/experimental-overview

Author: nastasha-solomon

.github/CODEOWNERS

@@ -2,7 +2,7 @@
 *                                           @elastic/docs
 
 # Templates, workflows, and config
-/.github/                                   @elastic/doc-leads @elastic/docs-tech-leads
+/.github/                                   @elastic/doc-leads
 /.github/workflows/                         @elastic/docs-engineering
 /.github/scripts/                           @elastic/docs-engineering
 /acrolinx/                                  @elastic/doc-leads
@@ -11,72 +11,69 @@
 /cloud-account/                             @elastic/admin-docs
 /deploy-manage/                             @elastic/admin-docs
 
-/explore-analyze/                           @elastic/experience-docs @elastic/developer-docs
+/explore-analyze/                           @elastic/ski-docs @elastic/developer-docs
 /explore-analyze/ai-features/agent-builder/ @elastic/developer-docs
-/explore-analyze/elastic-inference/         @elastic/developer-docs @elastic/experience-docs
-/explore-analyze/machine-learning/          @elastic/developer-docs @elastic/experience-docs
-/explore-analyze/query-filter/              @elastic/developer-docs @elastic/experience-docs
+/explore-analyze/elastic-inference/         @elastic/developer-docs @elastic/ski-docs
+/explore-analyze/machine-learning/          @elastic/developer-docs @elastic/ski-docs
+/explore-analyze/query-filter/              @elastic/developer-docs @elastic/ski-docs
 /explore-analyze/scripting/                 @elastic/admin-docs
 /explore-analyze/cross-cluster-search/      @elastic/developer-docs
 /explore-analyze/cross-project-search/      @elastic/developer-docs
 /explore-analyze/transforms/                @elastic/developer-docs
 
 /extend/                                    @elastic/core-docs
-/get-started/                               @elastic/core-docs @elastic/project-docs
+/get-started/                               @elastic/core-docs
 
 /manage-data/                               @elastic/admin-docs
 /manage-data/data-store/                    @elastic/admin-docs @elastic/developer-docs
-/manage-data/ingest/                        @elastic/ingest-docs
+/manage-data/ingest/                        @elastic/ski-docs
 
 /reference/                                 @elastic/docs
-/reference/apm-agents/                      @elastic/ingest-docs
+/reference/apm-agents/                      @elastic/ski-docs
 /reference/data-analysis/                   @elastic/docs
-/reference/data-analysis/observability/     @elastic/experience-docs
-/reference/data-analysis/kibana/            @elastic/experience-docs
+/reference/data-analysis/observability/     @elastic/ski-docs
+/reference/data-analysis/kibana/            @elastic/ski-docs
 /reference/data-analysis/machine-learning/  @elastic/developer-docs
-/reference/data-analysis/observability/     @elastic/experience-docs
+/reference/data-analysis/observability/     @elastic/ski-docs
 /reference/elasticsearch/clients/           @elastic/developer-docs
-/reference/fleet/                           @elastic/ingest-docs
+/reference/fleet/                           @elastic/ski-docs
 /reference/glossary/                        @elastic/docs
-/reference/ingestion-tools/                 @elastic/ingest-docs
-/reference/observability/                   @elastic/experience-docs
+/reference/ingestion-tools/                 @elastic/ski-docs
+/reference/observability/                   @elastic/ski-docs
 /reference/search/                          @elastic/developer-docs
-/reference/security/                        @elastic/experience-docs
+/reference/security/                        @elastic/ski-docs
 
 /release-notes/                             @elastic/docs
 
-/release-notes/apm-agents/                  @elastic/ingest-docs
+/release-notes/apm-agents/                  @elastic/ski-docs
 /release-notes/elastic-cloud-serverless/    @elastic/admin-docs @elastic/docs-serverless-release-team
 /release-notes/elastic-observability/       @elastic/ski-docs
 /release-notes/elastic-security/            @elastic/ski-docs
 /release-notes/elasticsearch-clients/       @elastic/developer-docs
-/release-notes/fleet-elastic-agent/         @elastic/ingest-docs
+/release-notes/fleet-elastic-agent/         @elastic/ski-docs
 /release-notes/intro/                       @elastic/docs
 
-/solutions/                                 @elastic/experience-docs @elastic/developer-docs
-/solutions/observability/                   @elastic/experience-docs
-/solutions/observability/apm/apm-agents/    @elastic/ingest-docs
-/solutions/observability/apm/apm-server/    @elastic/ingest-docs
-/solutions/observability/apm/ingest/        @elastic/ingest-docs
-/solutions/observability/apm/opentelemetry/ @elastic/ingest-docs
-/solutions/observability/get-started/       @elastic/ski-docs @elastic/project-docs
+/solutions/                                 @elastic/ski-docs @elastic/developer-docs
+/solutions/observability/                   @elastic/ski-docs
+/solutions/observability/apm/apm-agents/    @elastic/ski-docs
+/solutions/observability/apm/apm-server/    @elastic/ski-docs
+/solutions/observability/apm/ingest/        @elastic/ski-docs
+/solutions/observability/apm/opentelemetry/ @elastic/ski-docs
+/solutions/observability/get-started/       @elastic/ski-docs
 /solutions/search/                          @elastic/developer-docs
-/solutions/search/get-started/              @elastic/developer-docs @elastic/project-docs
-/solutions/security/                        @elastic/experience-docs
-/solutions/security/get-started             @elastic/experience-docs @elastic/project-docs
+/solutions/search/get-started/              @elastic/developer-docs
+/solutions/security/                        @elastic/ski-docs
+/solutions/security/get-started             @elastic/ski-docs
 
 /troubleshoot/                              @elastic/docs
 /troubleshoot/deployments/                  @elastic/admin-docs
 /troubleshoot/elasticsearch/                @elastic/admin-docs
-/troubleshoot/ingest/                       @elastic/ingest-docs
-/troubleshoot/kibana/                       @elastic/admin-docs @elastic/experience-docs
-/troubleshoot/monitoring/                   @elastic/admin-docs @elastic/experience-docs
+/troubleshoot/ingest/                       @elastic/ski-docs
+/troubleshoot/kibana/                       @elastic/admin-docs @elastic/ski-docs
+/troubleshoot/monitoring/                   @elastic/admin-docs @elastic/ski-docs
 /troubleshoot/observability/                @elastic/ski-docs
 /troubleshoot/security/                     @elastic/ski-docs
 
-# Raw migrated files
-/raw-migrated-files/                        @elastic/admin-docs
-
 # Legacy serverless docs
 /serverless/                                @elastic/admin-docs
 /serverless/serverless-changelog.asciidoc   @elastic/docs

.github/scripts/docs_ai_menu.cjs

@@ -6,13 +6,17 @@ const WORKFLOW_CONFIG = {
     label: 'Triage ([`docs-triage`](https://github.com/elastic/docs-actions/blob/main/.github/workflows/gh-aw-issue-triage.md)).',
     marker: '<!-- docs-ai-menu:triage -->',
   },
+  size: {
+    label: 'Size the work ([`docs-size`](https://github.com/elastic/docs-actions/blob/main/.github/workflows/gh-aw-issue-size.md)).',
+    marker: '<!-- docs-ai-menu:size -->',
+  },
   issueScope: {
     label: 'Scope the docs work ([`docs-issue-scope`](https://github.com/elastic/docs-actions/blob/main/.github/workflows/gh-aw-docs-issue-scope.md)).',
     marker: '<!-- docs-ai-menu:issue-scope -->',
   },
 };
 
-const WORKFLOW_ORDER = ['triage', 'issueScope'];
+const WORKFLOW_ORDER = ['triage', 'size', 'issueScope'];
 
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');

.github/workflows/add-new-team-label.yml

@@ -4,10 +4,14 @@ on:
   issues:
     types: [opened]
 
+permissions: {}
+
 jobs:
   add-needs-triage-label:
     name: Add `needs-team` label
     runs-on: ubuntu-latest
+    permissions:
+      issues: write
     steps:
       - name: Add the needs-team label
         uses: actions-ecosystem/action-add-labels@v1

.github/workflows/add-to-board.yml

@@ -12,30 +12,47 @@ jobs:
   route:
     runs-on: ubuntu-latest
     if: |
-      github.event.label.name == 'team:Ingest' ||
-      github.event.label.name == 'team:Experience' ||
-      github.event.label.name == 'team:Admin' ||
-      github.event.label.name == 'team:Developer' ||
-      github.event.label.name == 'team:DocsEng' ||
-      github.event.label.name == 'team:Platform' ||
-      github.event.label.name == 'team:Projects' ||
-      github.event.label.name == 'team:Search' ||
-      github.event.label.name == 'team:Security'
+      github.event.label.name == 'Team:Ingest' ||
+      github.event.label.name == 'Team:Experience' ||
+      github.event.label.name == 'Team:SKI' ||
+      github.event.label.name == 'Team:Admin' ||
+      github.event.label.name == 'Team:Developer' ||
+      github.event.label.name == 'Team:DocsEng' ||
+      github.event.label.name == 'Team:Platform' ||
+      github.event.label.name == 'Team:Projects' ||
+      github.event.label.name == 'Team:Search' ||
+      github.event.label.name == 'Team:Security'
     env:
+      # Retired Team:Ingest / Team:Experience map to the SKI board (1034).
       PROJECT_ID_MAP: |
         {
-          "team:Ingest":      "649",
-          "team:Experience":  "1034",
-          "team:Admin":       "1927",
-          "team:Developer":   "726",
-          "team:DocsEng":     "1625",
-          "team:Platform":    "1232",
-          "team:Projects":    "1415",
-          "team:Search":      "726",
-          "team:Security":    "1034"
+          "Team:Ingest":      "1034",
+          "Team:Experience":  "1034",
+          "Team:SKI":         "1034",
+          "Team:Admin":       "1927",
+          "Team:Developer":   "726",
+          "Team:DocsEng":     "1625",
+          "Team:Platform":    "1232",
+          "Team:Projects":    "1415",
+          "Team:Search":      "726",
+          "Team:Security":    "1034"
         }
     steps:
+      - name: Add the Team:SKI label
+        if: github.event.label.name == 'Team:Ingest' || github.event.label.name == 'Team:Experience'
+        uses: actions-ecosystem/action-add-labels@v1
+        with:
+          labels: Team:SKI
+
+      - name: Remove the retired team label
+        if: github.event.label.name == 'Team:Ingest' || github.event.label.name == 'Team:Experience'
+        uses: actions-ecosystem/action-remove-labels@v1
+        with:
+          labels: ${{ github.event.label.name }}
+
+      # Tolerate issues that don't carry needs-team (already triaged, etc.).
       - name: Remove needs-team label
+        continue-on-error: true
         uses: actions-ecosystem/action-remove-labels@v1
         with:
           labels: needs-team
@@ -45,5 +62,3 @@ jobs:
         with:
           project-url: https://github.com/orgs/elastic/projects/${{ fromJson(env.PROJECT_ID_MAP)[github.event.label.name] }}
           github-token: ${{ secrets.ADD_TO_BOARD_TOKEN }}
-          labeled: ${{ github.event.label.name }}
-          label-operator: OR

.github/workflows/docs-ai-menu.yml

@@ -14,6 +14,7 @@ on:
 
 permissions:
   contents: read
+  copilot-requests: write
   issues: write
 
 jobs:
@@ -66,6 +67,7 @@ jobs:
       contents: read
     outputs:
       triage_triggered: ${{ steps.evaluate.outputs.triage_triggered }}
+      size_triggered: ${{ steps.evaluate.outputs.size_triggered }}
       issue_scope_triggered: ${{ steps.evaluate.outputs.issue_scope_triggered }}
 
     steps:
@@ -87,16 +89,19 @@ jobs:
             const previousState = menu.parseMenuState(previousBody);
             const currentState = menu.parseMenuState(body);
             const triageTriggered = !previousState.triage.selected && currentState.triage.selected;
+            const sizeTriggered = !previousState.size.selected && currentState.size.selected;
             const issueScopeTriggered = !previousState.issueScope.selected && currentState.issueScope.selected;
 
             core.setOutput('triage_triggered', String(triageTriggered));
+            core.setOutput('size_triggered', String(sizeTriggered));
             core.setOutput('issue_scope_triggered', String(issueScopeTriggered));
 
   refresh-menu-after-trigger:
     name: Refresh AI menu after trigger
     needs: [evaluate-trigger]
     if: >-
       needs.evaluate-trigger.outputs.triage_triggered == 'true' ||
+      needs.evaluate-trigger.outputs.size_triggered == 'true' ||
       needs.evaluate-trigger.outputs.issue_scope_triggered == 'true'
     runs-on: ubuntu-latest
     permissions:
@@ -129,6 +134,13 @@ jobs:
               };
             }
 
+            if ('${{ needs.evaluate-trigger.outputs.size_triggered }}' === 'true') {
+              statusOverrides.size = {
+                detailsUrl: progressUrl,
+                status: 'in_progress',
+              };
+            }
+
             if ('${{ needs.evaluate-trigger.outputs.issue_scope_triggered }}' === 'true') {
               statusOverrides.issueScope = {
                 detailsUrl: progressUrl,
@@ -152,6 +164,7 @@ jobs:
     permissions:
       actions: read
       contents: read
+      copilot-requests: write
       discussions: write
       issues: write
       pull-requests: write
@@ -174,8 +187,19 @@ jobs:
         **Shared ownership**: Some paths have shared ownership (e.g., `/explore-analyze/machine-learning/` is shared by Developer and Experience). Pick the team whose keywords best match the issue content.
         **Internal projects**: If the issue seems related to an internal documentation project, initiative, or content strategy effort, apply `Team:Projects`.
         **Fallback**: If you genuinely cannot determine the owning team, apply `cross-team` so the issue stays visible to all teams.
-    secrets:
-      COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+
+  run-docs-size:
+    name: Docs AI / size
+    needs: [evaluate-trigger]
+    if: needs.evaluate-trigger.outputs.size_triggered == 'true'
+    permissions:
+      actions: read
+      contents: read
+      copilot-requests: write
+      discussions: write
+      issues: write
+      pull-requests: write
+    uses: elastic/docs-actions/.github/workflows/gh-aw-issue-size.lock.yml@v1
 
   run-docs-issue-scope:
     name: Docs AI / issue scope
@@ -184,12 +208,11 @@ jobs:
     permissions:
       actions: read
       contents: read
+      copilot-requests: write
       discussions: write
       issues: write
       pull-requests: write
     uses: elastic/docs-actions/.github/workflows/gh-aw-docs-issue-scope.lock.yml@v1
-    secrets:
-      COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
 
   refresh-menu-after-docs-triage:
     name: Refresh AI menu after docs triage
@@ -238,6 +261,53 @@ jobs:
               },
             });
 
+  refresh-menu-after-docs-size:
+    name: Refresh AI menu after docs size
+    needs: [evaluate-trigger, refresh-menu-after-trigger, run-docs-size]
+    if: always() && needs.evaluate-trigger.outputs.size_triggered == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+    concurrency:
+      group: docs-ai-menu-${{ github.event.issue.number }}
+      cancel-in-progress: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Refresh AI menu status
+        uses: actions/github-script@v9.0.0
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const menu = require(`${process.env.GITHUB_WORKSPACE}/.github/scripts/docs_ai_menu.cjs`);
+            const issueNumber = context.payload.issue.number;
+            const progressUrl = `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`;
+            const sizeResult = '${{ needs.run-docs-size.result }}';
+
+            await menu.upsertMenuComment({
+              core,
+              createIfMissing: false,
+              github,
+              context,
+              issueNumber,
+              statusOverrides: {
+                size: {
+                  conclusion: sizeResult === 'success'
+                    ? 'success'
+                    : sizeResult === 'cancelled'
+                      ? 'cancelled'
+                      : 'failure',
+                  detailsUrl: progressUrl,
+                  status: 'completed',
+                },
+              },
+            });
+
   refresh-menu-after-docs-issue-scope:
     name: Refresh AI menu after docs issue scope
     needs: [evaluate-trigger, refresh-menu-after-trigger, run-docs-issue-scope]

.github/workflows/docs-applies-to-sweep.yml

@@ -29,6 +29,7 @@ on:
 
 permissions:
   actions: read
+  copilot-requests: write
   contents: read
   discussions: write
   issues: write
@@ -44,5 +45,3 @@ jobs:
       scope-mode: ${{ inputs.scope-mode }}
       target-batch-size: ${{ inputs.target-batch-size }}
       max-per-fix-issue: ${{ inputs.max-per-fix-issue }}
-    secrets:
-      COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}

.github/workflows/docs-coherence-sweep.yml

@@ -29,6 +29,7 @@ on:
 
 permissions:
   actions: read
+  copilot-requests: write
   contents: read
   discussions: write
   issues: write
@@ -44,5 +45,3 @@ jobs:
       scope-mode: ${{ inputs.scope-mode }}
       target-batch-size: ${{ inputs.target-batch-size }}
       max-per-fix-issue: ${{ inputs.max-per-fix-issue }}
-    secrets:
-      COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}