Register set-available-attachment-versions extension

antora-playbook.yml

@@ -365,6 +365,9 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/generate-rp-connect-categories'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/modify-redirects'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/process-context-switcher'
+  # Point UI meta tags (properties-json-url, connect-json-url) at the newest
+  # generated JSON attachments that exist in the catalog, so version drift
+  # between release tags and generated JSON never produces 404 URLs
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/algolia-indexer/index'
     excludes: ['.thumbs','script', '.page-versions','.feedback-section','.banner-container']
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/archive-attachments'
@@ -396,6 +399,10 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/unlisted-pages'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/add-global-attributes'
   - '@redpanda-data/docs-extensions-and-macros/extensions/version-fetcher/set-latest-version'
+  # Registered after version-fetcher on purpose: this extension only sets
+  # attributes that are not already set, and its tooltip-disable branch reads
+  # latest-redpanda-tag, so the fetcher must run first.
+  - require: '@redpanda-data/docs-extensions-and-macros/extensions/set-available-attachment-versions'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/replace-attributes-in-attachments'
     data:
       replacements:

local-antora-playbook.yml

@@ -290,6 +290,9 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/convert-to-markdown'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/add-llms-directive'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/process-context-switcher'
+  # Point UI meta tags (properties-json-url, connect-json-url) at the newest
+  # generated JSON attachments that exist in the catalog, so version drift
+  # between release tags and generated JSON never produces 404 URLs
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/generate-index-data'
     data:
       sets:
@@ -328,6 +331,10 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/unlisted-pages'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/add-global-attributes'
   - '@redpanda-data/docs-extensions-and-macros/extensions/version-fetcher/set-latest-version'
+  # Registered after version-fetcher on purpose: this extension only sets
+  # attributes that are not already set, and its tooltip-disable branch reads
+  # latest-redpanda-tag, so the fetcher must run first.
+  - require: '@redpanda-data/docs-extensions-and-macros/extensions/set-available-attachment-versions'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/replace-attributes-in-attachments'
     data:
       replacements:

package.json

@@ -17,7 +17,7 @@
     "@asciidoctor/tabs": "^1.0.0-beta.5",
     "@modelcontextprotocol/sdk": "1.17.0",
     "@modelfetch/netlify": "0.15.2",
-    "@redpanda-data/docs-extensions-and-macros": "^5.0.0",
+    "@redpanda-data/docs-extensions-and-macros": "^5.3.5",
     "@sntke/antora-mermaid-extension": "^0.0.6",
     "algoliasearch": "^5.35.0",
     "hono-rate-limiter": "0.1.0",

preview-antora-playbook.yml

@@ -67,6 +67,9 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/convert-to-markdown'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/add-llms-directive'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/process-context-switcher'
+  # Point UI meta tags (properties-json-url, connect-json-url) at the newest
+  # generated JSON attachments that exist in the catalog, so version drift
+  # between release tags and generated JSON never produces 404 URLs
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/generate-index-data'
     data:
       sets:
@@ -105,6 +108,10 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/unlisted-pages'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/add-global-attributes'
   - '@redpanda-data/docs-extensions-and-macros/extensions/version-fetcher/set-latest-version'
+  # Registered after version-fetcher on purpose: this extension only sets
+  # attributes that are not already set, and its tooltip-disable branch reads
+  # latest-redpanda-tag, so the fetcher must run first.
+  - require: '@redpanda-data/docs-extensions-and-macros/extensions/set-available-attachment-versions'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/replace-attributes-in-attachments'
     data:
       replacements: