pmcfadin opened a new pull request, #315: URL: https://github.com/apache/cassandra-website/pull/315
## CASSANDRA-21315 Upgrades the `apache/cassandra-website` docs build pipeline from Antora 2.3 to Antora 3.1.14 and Node.js 20 to Node.js 24 LTS. This is a prerequisite for Cassandra 6 documentation contributions, which were authored and validated against Antora 3.1. ## Changes **`site-content/Dockerfile`** - Node.js: `v20.16.0` → `v24.14.1` (current active LTS; SHA256 verified for linux/amd64 and linux/arm64) - Replace `@antora/[email protected]` and `@antora/[email protected]` with `@antora/[email protected]` and `@antora/[email protected]` - Replace `antora-lunr` and `antora-site-generator-lunr` with `@antora/lunr-extension` **`site-content/docker-entrypoint.sh`** - Remove `--generator antora-site-generator-lunr` flag from the Antora invocation - Remove `DOCSEARCH_ENABLED`, `DOCSEARCH_ENGINE=lunr`, `NODE_PATH`, and `DOCSEARCH_INDEX_VERSION` env exports (required only by the deprecated Antora 2 custom generator) **`site-content/site.template.yaml`** - Add `antora.extensions` block registering `@antora/lunr-extension` (Antora 3 extension model for search) - `asciidoc.extensions` (`tabs-block.js`, `@djencks/asciidoctor-openblock`) left unchanged ## What is NOT changed - Branch matrix (`trunk`, `cassandra-5.0`, `cassandra-4.1`, `cassandra-4.0`, `cassandra-3.11`) - `stable` / `latest` alias behavior - `run.sh` command surface - JDK selection logic for generated docs per branch - `tabs-block.js` and `@djencks/asciidoctor-openblock` AsciiDoc extensions ## Validation - Docker image built clean with Antora 3.1.14 and Node 24.14.1 - Single-branch build (`trunk`) succeeded; `search-index.js` present confirming `@antora/lunr-extension` functional - Multi-branch build (`trunk`, `cassandra-5.0`, `cassandra-4.1`) succeeded; version directories `4.1/`, `5.0/`, `6.0/`, `latest/`, `stable/` all present - `stable/` and `latest/` alias behavior confirmed unchanged - xref errors in build output are pre-existing in upstream trunk content, not regressions from this upgrade ## AI Assistance This PR was prepared with AI assistance (Claude, Anthropic). All changes were reviewed against the `apache/cassandra-website` source and validated with local builds. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
