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