Most documentation has a structural problem that exists before any individual piece of writing: nobody has decided what kind of content belongs in the documentation and what each content type is supposed to do. The result is documentation that mixes procedures, explanations, reference material, and tutorials in ways that make all four harder to use. #diataxis #technicalwriting https://stevearrants.substack.com/p/documentation-frameworks-a-field