Skip to content

[backport camel-spring-boot-4.22.x] Reword micrometer shutdown-filters Javadoc to avoid mis-nested AsciiDoc - #1974

Merged
davsclaus merged 1 commit into
apache:camel-spring-boot-4.22.xfrom
ammachado:chore/website-asciidoc-fixes-4.22.x
Sep 14, 2026
Merged

davsclaus merged 1 commit into
apache:camel-spring-boot-4.22.xfrom
ammachado:chore/website-asciidoc-fixes-4.22.x

Conversation

@ammachado

Copy link
Copy Markdown
Contributor

Summary

Backport of #1973 to camel-spring-boot-4.22.x. The camel-spring-boot/4.22.x/starters/micrometer page is one of the 35 documentation pages with no .md twin on the website, see apache/camel-website#1746.

The Javadoc of camel.metrics.log-metrics-on-shutdown-filters contains two * characters (`*` and `camel.exchanges.*`). In the generated starters/micrometer.adoc table, Asciidoctor pairs them as constrained bold across the monospace spans and emits <code><strong></code> ... <code>camel.exchanges.</strong></code>. The website's HTML-to-Markdown step then loses article.doc and skips the page.

Change

Reword the Javadoc so only one * remains:

List of metrics (comma separated) to log when application is shutting down. You can use a wildcard to log any metrics matching a pattern, for example camel.exchanges.* (default to all metrics available).

Cherry-picked from the main commit with -x. The generated micrometer.adoc conflicted only because 4.22.x has no log-metrics-on-shutdown-format option (17 options instead of 18); it was regenerated by building the starter on this branch, and the result differs from the branch by a single table line.

Verification

Rendered the regenerated 4.22.x micrometer.adoc with Asciidoctor.js and parsed it with the website's node-html-parser: before the change article.doc is lost (page skipped); after it, the HTML is valid and article.doc is found. Module tests were not run: the change touches a Javadoc comment and generated docs only.

🤖 Generated with 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.

The Javadoc of camel.metrics.log-metrics-on-shutdown-filters is copied
into the generated starters/micrometer.adoc table. Its two `*` characters
(`*` and `camel.exchanges.*`) pair up as AsciiDoc constrained bold across
the monospace spans, so Asciidoctor emits <code>...<strong></code>. The
website's HTML-to-Markdown step cannot recover from that nesting and
skips the page, leaving starters/micrometer.md missing.

Reword the sentence so only one `*` remains. A passthrough (+...+) is
avoided because it would also show up literally in the Spring
configuration-metadata tooltip.

See apache/camel-website#1746

_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._

(cherry picked from commit 6cca665)
@davsclaus
davsclaus merged commit 825f6ec into apache:camel-spring-boot-4.22.x Sep 14, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants