ammachado opened a new pull request, #1973:
URL: https://github.com/apache/camel-spring-boot/pull/1973

   ## Summary
   
   The `starters/micrometer` page (`next` and `4.22.x`) 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` is copied 
into the generated option table of 
`docs/spring-boot/modules/ROOT/pages/starters/micrometer.adoc`. It contains two 
`*` characters (`` `*` `` and `` `camel.exchanges.*` ``), which Asciidoctor 
pairs as constrained bold across the monospace spans:
   
   ```html
   <code><strong></code> character to log any metrics containing the wildcard, 
for example <code>camel.exchanges.</strong></code>
   ```
   
   Browsers tolerate this, but the website's HTML-to-Markdown step 
(`node-html-parser`) loses `article.doc` and skips the page.
   
   ## Change
   
   Reword the Javadoc so only one `*` remains in the table cell:
   
   > 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).
   
   A `+...+` passthrough is avoided on purpose: the same text ends up in the 
Spring configuration-metadata tooltip, where the `+` signs would show literally.
   
   `micrometer.json` and `micrometer.adoc` are regenerated by building the 
starter (`-pl components-starter/camel-micrometer-starter -am`), not edited by 
hand.
   
   ## Verification
   
   Rendered the generated `micrometer.adoc` with Asciidoctor.js and parsed it 
with the website's `node-html-parser`:
   
   | | `valid()` | `article.doc` found | `<code>..<strong></code>` |
   |---|---|---|---|
   | before | false | no (page skipped) | 1 |
   | after | true | yes | 0 |
   
   The example still renders as `<code>camel.exchanges.*</code>`. Module tests 
were not run: the change touches a Javadoc comment and generated docs only.
   
   The same fix for `camel-spring-boot-4.22.x` is in a separate PR. The option 
does not exist on 4.18.x or 4.14.x.
   
   🤖 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]

Reply via email to