daps
daps copied to clipboard
[Adoc] Grouping of callouts
Problem description
When using callouts you can re-use the same callout number for various lines across the example. For some reason, DAPS renumbers the callouts for each repetition and then groups the renumbering together. This causes a seemingly broken callout list (formatting) and confuses readers.
https://github.com/SUSE/doc-caasp/issues/479
the original file is this: https://github.com/SUSE/doc-caasp/blob/master/adoc/deployment-loadbalancer.adoc
Is this some remnant of the docbook stylesheet? Some reason the callouts can't be the same in multiple lines? If so can we somehow change the formatting output of the callout bubbles? Maybe 1/2/3 or make it more clear that those are groups and not just some random line skips?
Expected behavior
Either implement the same behavior as in asciidoctor and use 3 callouts for the 8 lines that are tagged.
Alternatively: Change formatting to make it more clear these are deliberate groups of the same callout but with separate numbers.
Steps to reproduce the behavior
- Use code sample with callouts
- Re-use callout for multiple unconnected lines
- Get grouped list