3 ms·
Neither Python's style nor Haskell's style is sufficient. Howtos ("cookbook" style) and reference information are completely inadequate on their own. The only
by throw10920 5y ago
Neither Python's style nor Haskell's style is sufficient. Howtos ("cookbook" style) and reference information are completely inadequate on their own.
The only acceptable documentation is that which hits all four quadrants of the Divio documentation system[1]: tutorials, how-to guides, reference information, and conceptual explanations. Each of these kinds is necessary in a different situation.
If there's a "cultural" aspect, then it's only in which of the four kinds of docs that those two communities ignore.
[1] https://documentation.divio.com/ https://documentation.divio.com/
- kqr 5y agoI'm not completely convinced that these four categories are The Categories – but the general idea is absolutely what I mean. Thanks for the reference!