"Documentation needs to include and be structured around its four different functions: tutorials, how-to guides, explanation and technical reference. Each of them requires a distinct mode of writing. People working with software need these four different kinds of documentation at different times, in different circumstances - so software usually needs them all. And documentation needs … Continue reading A Theory of Documentation
Tag: Minto’s Pyramid Principle
The Minto Pyramid Principle for Writing
Barbara Minto's "The Minto Pyramid Principle" is a how-to guide for writing concise reports in a management consulting firm that has been around for years. I wrote a one sheet summary of her book over a decade ago that I still sometimes find to be a useful aid for writing. While it might be overkill … Continue reading The Minto Pyramid Principle for Writing
cafebedouin.org 