Merge branch 'main' into add-deeplink-anchors-dropdown

Author: theletterf

.github/updatecli/updatecli.d/versions.yml

@@ -25,20 +25,14 @@ actions:
       title: '[Automation] Bump product version numbers'
 
 sources:
-  # TODO Automate only for patch releases
-  # latest-stack-version:
-  #   name: Get latest stack version
-  #   kind: githubrelease
-  #   transformers:
-  #     - trimprefix: v
-  #   spec:
-  #     owner: elastic
-  #     repository: elasticsearch
-  #     token: '{{ requiredEnv "GITHUB_TOKEN" }}'
-  #     username: '{{ requiredEnv "GITHUB_ACTOR" }}'
-  #     versionfilter:
-  #       kind: regex
-  #       pattern: "v9.(\\d*).(\\d*)$"
+  latest-stack-version:
+    name: Get latest stack version
+    kind: json
+    spec:
+      files:
+        - https://artifacts.elastic.co/releases/stack.json
+      engine: dasel/v2
+      key: "releases.last().version"
 
   latest-edot-android-version:
     name: Get latest release version for the apm-agent-android
@@ -292,15 +286,15 @@ sources:
         pattern: "^@elastic/apm-rum@(\\d*).(\\d*).(\\d*)$"
 
 targets:
-  # update-docs-docset-stack:
-  #   name: 'Update config/versions.yml stack {{ source "latest-stack-version" }}'
-  #   scmid: githubConfig
-  #   sourceid: latest-stack-version
-  #   kind: file
-  #   spec:
-  #     file: config/versions.yml
-  #     matchpattern: '(stack: &stack\s+base: [\d\.]+\s+current:)\s+(.+)'
-  #     replacepattern: '$1 {{ source "latest-stack-version" }}'
+  update-docs-docset-stack:
+    name: 'Update config/versions.yml stack {{ source "latest-stack-version" }}'
+    scmid: githubConfig
+    sourceid: latest-stack-version
+    kind: file
+    spec:
+      file: config/versions.yml
+      matchpattern: '(stack: &stack\s+base: [\d\.]+\s+current:)\s+(.+)'
+      replacepattern: '$1 {{ source "latest-stack-version" }}'
 
   update-docs-docset-android:
     name: 'Update config/versions.yml edot-android {{ source "latest-edot-android-version" }}'

.github/workflows/updatecli.yml

@@ -16,7 +16,7 @@ jobs:
   bump:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Get token
         id: get_token
@@ -35,6 +35,7 @@ jobs:
       - uses: elastic/oblt-actions/updatecli/run@v1
         with:
           command: apply --config .github/updatecli/updatecli.d/versions.yml --values .github/updatecli/values.d/scm.yml
+          version-file: .updatecli-version
         env:
           GITHUB_TOKEN: ${{ steps.get_token.outputs.token }}
 

.updatecli-version

@@ -0,0 +1 @@
+v0.105.1

docs/contribute/_snippets/tag-processing.md

@@ -2,17 +2,23 @@
 
 Specifically for versioned products, badges will display differently when the `applies_to` key specifies a product version that has not been released to our customers yet.
 
-* `Planned` (if the lifecycle is preview, beta, or ga)
-  
-  Example: {applies_to}`stack: ga 99.99`
-* `Deprecation planned` (if the lifecycle is deprecated)
-  
-  Example: {applies_to}`stack: deprecated 99.99`
-* `Removal planned` (if the lifecycle is removed) 
+The following table shows how badges for versioned products are displayed based on the release status for each lifecycle value. Hover over the example badges for the tooltip text.
 
-  Example: {applies_to}`stack: removed 99.99`
+| Lifecycle   | Release status | Badge text examples                   |
+|-------------|----------------|---------------------------------------|
+| preview     | prerelease     | {applies_to}`stack: preview 99.99`    |
+|             | post-release   | {applies_to}`stack: preview 9.1`      |
+| beta        | prerelease     | {applies_to}`stack: beta 99.99`       |
+|             | post-release   | {applies_to}`stack: beta 9.1`         |
+| ga          | prerelease     | {applies_to}`stack: ga 99.99`         |
+|             | post-release   | {applies_to}`stack: ga 9.1`           |
+| deprecated  | prerelease     | {applies_to}`stack: deprecated 99.99` |
+|             | post-release   | {applies_to}`stack: deprecated 9.1`   |
+| removed     | prerelease     | {applies_to}`stack: removed 99.99`    |
+|             | post-release   | {applies_to}`stack: removed 9.1`      |
+
+This is computed at build time (there is a docs build every 30 minutes). The documentation team tracks and maintains released versions for these products centrally in [`versions.yml`](https://github.com/elastic/docs-builder/blob/main/config/versions.yml).
 
-This is computed at build time (there is a docs build every 30 minutes). The documentation team tracks and maintains released versions for these products centrally in [`versions.yml`](https://github.com/elastic/docs-builder/blob/main/config/versions.yml). 
 When multiple lifecycle statuses and versions are specified in the sources, several badges are shown.
 
 :::{note}