I was going to just bite my tongue, but couldn't let this go...
On 2013-03-18 11:33 AM, Stan Hoeppner stan@hardwarefreak.com wrote:
On 3/17/2013 3:50 PM, Timo Sirainen wrote:
It's the best I can do myself. I have no idea how they could be improved in any major way. They say that the software developer himself is the worst possible person to write its documentation, because he can't understand what others find difficult.. I don't know who "they" is.
I think it was pretty obvious that he meant 'the documentation'... talk about being a smart ass.
Wietse writes all the Postfix documentation himself. It comes naturally when one performs formal software development, not ad hoc, because documentation precedes coding.
<snip>
Really nice Stan. You just proved the old axiom of what happens when you 'ass-u-me'.
Writing good docs may come easy to some people (I can't speak for Wietse as to whether or not this is true for him), but I'd argue that it may not be as easy as you seem to think.
Too bad the rest of your decent suggestions got clobbered by the condescending attitude. And I wonder how much time you have spent helping Timo get the documentation in order...