You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
Version 1
Next »
Readers of documentation value these qualities.
Gretchen Hargis et al. make the qualities actionable by first grouping them. Hargis defines these groups for readers of documentation.
- Easy to find
- Easy to understand
- Easy to use
These quality attributes are associated with these groups.
Reducing the amount of quality attributes to nine and grouping them into three groups makes working on documentation actionable, because these grouped qualities are easier to manage. Nonetheless creating quality documentation is an iterative process. The quality attributes also do not demand a specific process, may it top-down or bottom up, agile or not.
To make them really actionable we need to get more specific. We need to provide guidelines to follow in order to realize the values we desire. We call these guidelines principles. Before we do this, we first continue to identify the qualities for other roles.