"I don’t want you to conclude that it’s just a matter of aesthetics. Yes, Webster’s [1913] definitions are prettier. But they are also better. In fact they’re so much better that to use another dictionary is to keep yourself forever at arm’s length from the actual language.Recall that the New Oxford, for the word 'fustian,' … Continue reading You’re Probably Using the Wrong Dictionary
Category: educational
A Theory of Documentation
"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
