daps icon indicating copy to clipboard operation
daps copied to clipboard

[Adoc] Grouping of callouts

Open r0ckarong opened this issue 5 years ago • 2 comments

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

r0ckarong avatar Sep 16 '19 12:09 r0ckarong