"Documentation needs to include and be structured around its four different functions: tutorials, how-to guides, explanation and technical reference. Each of them requires a distinct mode of writing. People working with software need these four different kinds of documentation at different times, in different circumstances - so software usually needs them all. And documentation needs … Continue reading A Theory of Documentation
Category: life
Open Questions – Gwern.net
"Why do humans, pets, and even lab animals of many species kept in controlled lab conditions on standardized diets appear to be increasingly obese over the 20th century? What could possibly explain all of them simultaneously becoming obese?" "Why does writing in the morning (anecdotally so far) seem to be so effective for writers, even … Continue reading Open Questions – Gwern.net
