I think this also applies to any document/article/text that is mainly there to convey information. People will skim through it quickly to extract relevant fact

I think this also applies to any document/article/text that is mainly there to convey information. People will skim through it quickly to extract relevant facts of interest. The longer the text, the harder this is and the less likely someone will do it. In English we call it "Wall of Text" in German sometimes "Bleiwüste"[0]. Things that help: - using bullet points - simple, clear language - a concise abstract/tldr - interactive elements when possible such as links and expandable elements: In HTML there is a standard element that is seldomly used but to me seems very useful: the <details>/<summary> element[1]. I think it should be used more often! Perhaps in combination with a more distinct color/styling too. Here is an interesting tutorial/article that uses it[2]. You can expand text to get more background information and explanations on certain topics. This practice condenses the text, making it less daunting at a first glance and also makes a clear distinction between core content and supplementary information, which increases the overall structure. [0] https://de.wikipedia.org/wiki/Bleiw%C3%BCste https://de.wikipedia.org/wiki/Bleiw%C3%BCste [1] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details https://developer.mozilla.org/en-US/docs/Web/HTML/Element/de... [2] https://x775.net/2019/03/18/Introduction-to-Datalog.htm2 https://x775.net/2019/03/18/Introduction-to-Datalog.htm2