ammachado opened a new pull request, #26353:
URL: https://github.com/apache/camel/pull/26353
## Summary
The User Manual menu on the website comes straight from
`docs/user-manual/modules/ROOT/nav.adoc` on `main`. Nothing in camel-website
reorders it (see apache/camel-website#1740). The manual is unversioned
(`version: ~`), so this change reaches the site at the next website build and
doesn't need a backport.
The "Resources & Guides" section had drifted into a loosely alphabetical
list mixing four kinds of pages: tools, how-tos, contributor docs, and a
website link. As a result, Camel Developer Console showed up third and route
startup ordering sixth. This PR splits it by purpose:
| Section | Entries |
|---|---|
| Getting started (existing) | + Examples, + Books |
| **Tools** (new) | Camel CLI, Camel Maven Plugin, Camel Developer Console |
| **How-to Guides** (new) | Property placeholders, Variables, Error
Registry, Testing, REST DSL, Component/Endpoint/DataFormat DSL, Route startup
ordering, Graceful Shutdown |
| **Contributing** (new) | Building, Writing Components, Improving the
Documentation, Generating SBOMs, Release guide |
It also fixes two duplicates:
- `error-handler.adoc` was listed twice ("Error handler" in Resources &
Guides, "Error Handler" in Architecture). It now appears only under
Architecture, next to Exception Clause.
- Two entries were both labeled "Bean Binding". The RouteTemplate child,
which points to `route-template-bean-binding.adoc`, now uses its page title,
"Route Template Bean Binding".
Migration and Upgrade, Security, Architecture, and Domain Specific Languages
are otherwise unchanged. Contributing sits just above Reference and FAQ because
Antora appends `references.adoc` and `faq/nav.adoc` after `nav.adoc` (see
`docs/user-manual/antora.yml`).
No page is renamed, moved, or removed, so all URLs stay the same and no
upgrade-guide entry is needed.
## Verification
A script compared the old and new `nav.adoc`:
- The sorted list of `xref:`/`link:` targets is identical except for one
fewer `error-handler.adoc`.
- All 25 child entries (`***`) keep the same parent entry.
- The only label change is the Route Template Bean Binding rename.
Not verified: I haven't rendered the manual with Antora locally. A website
preview build would confirm the final menu.
🤖 Generated with [Claude Code](https://claude.com/claude-code) on behalf of
Adriano Machado (@ammachado)
_This was generated by an AI agent and may contain inaccuracies. Please
verify before relying on it._
--
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]
