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..