Marvin Blome
Divide content into different tabs. That way, content is grouped and only relevant information gets displayed.
Examples:
  • View different code blocks in the same location (switch tabs to view the code blocks in a different programming language). Here’s an image and further information: https://docs-as-co.de/news/tabs-asciidoc/
  • For Installation Guides, choose the right operating system and only display content for that specific OS.
Currently AsciiDoc requires a plugin for tabs: https://stackoverflow.com/questions/38211766/using-tabs-in-asciidoc-spring-rest-docs