On Mon, 2013-03-18 at 18:37 +0200, Timo Sirainen wrote:
I don't know who "they" is. Wietse writes all the Postfix documentation himself. It comes naturally when one performs formal software development, not ad hoc, because documentation precedes coding. I would assume you do ad hoc development like most 20 somethings, coding on the fly when you get an idea, no formal definitions, no flow charting, no pseudo code, etc. Correct? If so this is 99% of the reason the documentation suffers, and this is typical of today's crop of young developers, unfortunately.
Because it significantly increases development times, and when you're basically doing everything yourself there's nobody else reading those anyway.
Or actually for the larger changes I do write design docs and usually send them to this mailing list, e.g.:
http://www.dovecot.org/list/dovecot/2012-February/064114.html http://www.dovecot.org/list/dovecot/2012-February/063665.html http://www.dovecot.org/list/dovecot/2010-November/055196.html http://www.dovecot.org/list/dovecot/2010-July/050832.html http://www.dovecot.org/list/dovecot/2010-January/046148.html
So it's not all ad hoc..