I’m constantly amazed at the amount of documentation people are inclined to create without including a single example. Man pages that devote pages worth of command-line options, flags, grammar, caveats, historical anecdotes, and NOT A SINGLE EXAMPLE. Textbooks that devote pages to a particular API, then expose it all in one monolithic program. Countless reference documentation on HTML […]
Documentation Needs Examples (Duh)
September 23rd, 2006 · 3 Comments
Tags: SoftwareDev
