davsclaus commented on PR #29473: URL: https://github.com/apache/camel/pull/29473#issuecomment-6768392921
@oscerd about the website and docs part you raised: I updated the Documentation section in bf230cc6d465 after a closer look at how the Kamelet pages are built today. - **Own section, not mixed with components.** The Kamelets get their own section of the docs, the same way data formats and languages have one: a `kamelets` module of the `components` Antora component (`docs/components/modules/kamelets/`) with its own `nav.adoc` from a `docs/kamelets-nav.adoc.template`, listed in `docs/components/antora.yml`. The site shows a separate *Kamelets* section next to Data Formats and Languages, with its own index page and the catalog cards as today. They do not end up in the components list. - **Pages generated in the Camel build.** Today the per-Kamelet pages are not in the repository; the website creates them (`camel-kamelets: docs/indexPages.yml` with `examples/js/kamelets.js`). After the move a `camel-package-maven-plugin` goal generates the pages, their icons and the nav, and they are committed like component pages, so they can be reviewed in a PR and read on GitHub. This has to be done from the start: `XRefCheckMojo` also reads the nav files, so a nav listing pages only the website creates would fail it. - **What it gives.** The pages are versioned with the Camel docs (LTS branches included) and found by the site search, which skips `/camel-kamelets/` today. - **Website side.** Old `/camel-kamelets/...` URLs are redirected in `camel-website: static/.htaccess`; the playbook keeps the old repository's `4.22.x` and `4.18.x` until those lines end. `camel cmd catalog doc` (`CatalogDoc.java`) links to the new pages for the versions that have them. If you would rather keep the presentation as it is, the document still lists the simpler alternative: a separate `camel-kamelets` Antora component sourced from `apache/camel`, with the same URLs, but the pages stay out of the search and out of the Camel xref check. _Claude Code on behalf of davsclaus_ -- 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]
