organisation
Organisation
The section breakdown of this documentation is largely inspired by the divio model:
Quick summary:
| Tutorials | How-to guides | Reference | Explanation | |
| oriented to | learning | a goal | information | understanding |
| must | allow the newcomer to get started | show how to solve a specific problem | describe the machinery | explain |
| its form | a lesson | a series of steps | dry description | discursive explanation |
| analogy | teaching a small child how to cook | a recipe in a cookery book | a reference encyclopaedia article | an article on culinary social history |