ADR-002: Use DIVIO documentation system
According DIVIO documentation system, documentation can have different and often conflicting needs.
Follow the guidelines of DIVIO documentation system, adding a new type of document Design. In particular, decide the type of a document according this table:
solving a problem
allow the newcomer to get started
show how to solve a specific problem
describe the machinery
understand a problem, design a solution and evaluate it
a series of steps
analysis and problem solving
teaching a small child how to cook
a recipe in a cookery book
a reference encyclopaedia article
an article on culinary social history
Make sure that the type of a document (i.e. tutorial, how-to guide, reference or explanation) is obvious for the reader.
The documentation is used also during the design of Dokmelody, so an additional type of documentation will be added: design.
Writers can focus on the type of document to write, according its scope.
Easier navigation and comprehensions of documentation for readers.