CASSANDRA-21315: Upgrade docs build stack to Antora 3.1 and Node.js 24 LTS#315
Open
pmcfadin wants to merge 1 commit intoapache:trunkfrom
Open
CASSANDRA-21315: Upgrade docs build stack to Antora 3.1 and Node.js 24 LTS#315pmcfadin wants to merge 1 commit intoapache:trunkfrom
pmcfadin wants to merge 1 commit intoapache:trunkfrom
Conversation
- Pin Node.js to v24.14.1 (current active LTS) with verified SHA256 hashes - Replace @antora/cli@2.3 / @antora/site-generator-default@2.3 with @antora/cli@3.1.14 / @antora/site-generator@3.1.14 - Replace antora-lunr / antora-site-generator-lunr with @antora/lunr-extension - Remove --generator antora-site-generator-lunr from antora invocation - Remove DOCSEARCH_ENGINE=lunr / NODE_PATH env wiring (Antora 2 generator deps) - Register @antora/lunr-extension as an Antora extension in site.template.yaml (Antora 3 extension model; Asciidoctor extensions remain under asciidoc.extensions) Branch matrix, alias behavior, tabs-block.js, and openblock extension unchanged. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Contributor
Author
|
Staged into https://cassandra.staged.apache.org/doc/latest/ and looks good |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
CASSANDRA-21315
Upgrades the
apache/cassandra-websitedocs 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/Dockerfilev20.16.0→v24.14.1(current active LTS; SHA256 verified for linux/amd64 and linux/arm64)@antora/cli@2.3and@antora/site-generator-default@2.3with@antora/cli@3.1.14and@antora/site-generator@3.1.14antora-lunrandantora-site-generator-lunrwith@antora/lunr-extensionsite-content/docker-entrypoint.sh--generator antora-site-generator-lunrflag from the Antora invocationDOCSEARCH_ENABLED,DOCSEARCH_ENGINE=lunr,NODE_PATH, andDOCSEARCH_INDEX_VERSIONenv exports (required only by the deprecated Antora 2 custom generator)site-content/site.template.yamlantora.extensionsblock registering@antora/lunr-extension(Antora 3 extension model for search)asciidoc.extensions(tabs-block.js,@djencks/asciidoctor-openblock) left unchangedWhat is NOT changed
trunk,cassandra-5.0,cassandra-4.1,cassandra-4.0,cassandra-3.11)stable/latestalias behaviorrun.shcommand surfacetabs-block.jsand@djencks/asciidoctor-openblockAsciiDoc extensionsValidation
trunk) succeeded;search-index.jspresent confirming@antora/lunr-extensionfunctionaltrunk,cassandra-5.0,cassandra-4.1) succeeded; version directories4.1/,5.0/,6.0/,latest/,stable/all presentstable/andlatest/alias behavior confirmed unchangedAI Assistance
This PR was prepared with AI assistance (Claude, Anthropic). All changes were reviewed against the
apache/cassandra-websitesource and validated with local builds.