Docs: Align AsciiDoc callout syntax by tkmsaaaam · Pull Request #7147 · micrometer-metrics/micrometer (original) (raw)

Summary

This PR refactors the markup in example blocks to ensure that code callouts are correctly recognized and rendered by Antora/Asciidoctor.

Problem

The current documentation uses a manual ordered list (1., 2., etc.) for code explanations. This causes two issues:

Broken Links: The interactive links between the code tags (<1>) and the descriptions do not function.

Rendering Issues: The callout icons (e.g., the stylized "❶") do not appear in the description list, making the documentation less readable and inconsistent with the Spring official style.

Changes

Updated manual numeric lists to standard AsciiDoc callout list syntax (<1>, <2>, etc.).

Ensured all code snippets and their respective callouts are encapsulated within ==== (Example blocks) for proper visual grouping.