The 4 types of technical documentation
According to Daniele Procida, what we call documentation is fundamentally not one thing, but four: Tutorials, how-to guides, references and explanations.
One sentence per line
When writing source documentation in a format such as Markdown, reStructuredText or AsciiDoc, I recommend you place every sentence on its own line and don't use fixed-column word-wrapping. Advantages It prevents reflows (meaning a change early in th…