davsclaus opened a new pull request, #1768:
URL: https://github.com/apache/camel-website/pull/1768

   Fixes the first half of #1764: the offline bundle list in `llms.txt`.
   
   ## What changed
   
   - `gulp/helpers/llms-txt.js` now fills an `<!-- offline-bundles -->` 
placeholder in `llms-txt-template.md` with one download link per versioned 
component directory Antora built (`public/components/<major.minor>.x`, newest 
first). That directory set is exactly the branch list in 
`antora-playbook-production.yml`, so the list follows the documented versions 
instead of being edited by hand. Today it renders 4.22 and 4.18, both of which 
have a `docs-<version>` release (verified both zips return 200).
   - Rendering fails the build rather than publishing an unfilled or empty list.
   - Dropped the stale caveat that the 4.18 bundle lacks the YAML DSL schema: 
`scripts/generate-offline-bundle.js` has fetched `camelYamlDsl-canonical.json` 
into the bundle for a while.
   - `llms.txt` states that `next` has no bundle and is read online. A `next` 
bundle would be stale within days and would need a `main` branch mapping in the 
bundle script plus a scheduled workflow, so I left it out on purpose — say so 
if you want it anyway.
   - README: documents that the list is generated and that the bundle workflow 
must be run when a new LTS branch is added to the playbook, otherwise the 
generated link 404s until then.
   - `test/llms-txt-test.js` covers version discovery/ordering, rendering, the 
failure modes, and that the real template carries the placeholder.
   
   ## Not in this PR
   
   The "Start here" section (Markdown links to *What is Apache Camel*, *When to 
use*, the trust page, Camel DNA and a blog index) and adding the website pages 
to the bundle depend on the Markdown mirrors from #1762 and #1763, which do not 
exist yet. They will follow once those land.
   
   ## Verification
   
   - `yarn test`: 17 pass.
   - Full `yarn build` from the root: Antora, Hugo (with 
`HUGO_PARAMS_GitHubToken`, an unauthenticated run hits GitHub API rate limits 
on release-note fetches), `build:post` and `build:minify` all succeed; 
`public/llms.txt` lists 4.22 and 4.18.
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)


-- 
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]

Reply via email to