davsclaus opened a new pull request, #25943:
URL: https://github.com/apache/camel/pull/25943
## Summary
- Adds two AI-agent guidelines to the "Documentation Conventions" section of
`AGENTS.md`:
1. Avoid explicit `[[anchor]]` blocks before headings — AsciiDoc already
auto-generates an id (`_`-prefixed) from the heading text, and an explicit
anchor silently diverges from that, breaking `xref:` links that expect the
auto-generated id.
2. Editing a component's `src/main/docs/*.adoc` requires regenerating the
mirrored copy under `catalog/camel-catalog/src/generated/resources/.../docs/`,
or CI's "uncommitted changes" check fails — this applies to doc-only edits too,
not just code-driven metadata changes.
- Prompted by fixing a broken `structured_error_exchange_properties` anchor
across several AI component docs, and a follow-up PR (#25941) to regenerate the
catalog copies that were missed the first time.
_Claude Code on behalf of davsclaus_
🤖 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]
