Quotation of the Day for September 6, 2013
"Wikis are an abomination. They are the worst form of "documentation".
"First of all: assuming they work as intended, they have no coherent voice.
"Have you ever taken a class with multiple teachers at once? Probably not, because it doesn't work very well (with exceptions for things like partnered dancing where there are distinct lead/follow parts).
"Worse still: have you ever taken a class where there's one jackass in the room who keeps constantly raising his hand and offering his own (often incorrect) opinions? Wikis are like that, except they actively encourage random people to interrupt the teacher with their own interjections."
- Steve Losh, on writing documentation.
[http://stevelosh.com/blog/2013/09/teach-dont-tell/]
Submitted by: Mike Krawchuk Sep. 4, 2013
|