Robert Kratky

See the following -

Documentation Based on User Stories

A typical manual page on a Unix-like system is a good example of feature-based documentation. Ideally, it contains an exhaustive list of all features (options, commands, parameters) of a program, it explains what the features are good for, and it provides examples of how to use them. The measure of quality in the case of this type of documentation is comprehensiveness and thoroughness. On the other hand, a recipe in a cookbook is a classic example of action-oriented documentation that guides the user towards the completion of a specific goal by explaining clear-cut steps...