Category: writing Docs

  • Quality KPIs for Documentation

    In Technical Writing: How to Write Software Documentation, Jordan Stanchev shares the outcomes of his research in defining high-quality software documentation. By establishing key performance indicators, it becomes possible to precisely gauge the direction of improvement of any documentation project.

    Quality KPIs for docs:

    1. Helpful
    2. Comprehensive
    3. Searchable
    4. Visual
    5. Usable
    6. Readable
    7. Reliable
    8. Grammatically correct
    9. Translatable and localization friendly
    10. Accessible
    11. Uses appropriate tone

    The scores for these KPIs should stem from User Research and Analysis