This article shares 10 ways to improve documentation. It’s written for software development in the project life cycle, it applies well to knowledge bases and support documentation.
Here are the topics it covers:
- Document with pictures if possible
- Give examples
- Don’t presume to assume
- Anticipate problems
- Test your documentation
- Humanize your work
- Explore new technologies
- Do the documentation yourself if possible
- Coordinate end-user documentation with internal/system documentation
- Follow department or corporate documentation guidelines
Check out the article and read about each topic in the original article here.
Also published on Medium.