Date: Fri, 15 Jul 2005 13:48:56 -0400 From: Chuck Swiger <cswiger@mac.com> Cc: doc@freebsd.org, cvs-all@freebsd.org, ports-committers@freebsd.org Subject: Re: cvs commit: ports/graphics/djvulibre Makefile ports/textproc/wordnet Makefile Message-ID: <42D7F708.2060007@mac.com> In-Reply-To: <20050714222749.GD80131@submonkey.net> References: <200507132352.j6DNqtUS011697@repoman.freebsd.org> <200507141557.06236.Mikhail.Teterin@murex.com> <20050714220943.GB80131@submonkey.net> <200507150023.44016.lofi@freebsd.org> <20050714222749.GD80131@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
[ ...rampant cross-posting trimmed somewhat... ] WARNING: Contains asbestos. Do not eat. This message has been carefully sanitized of all personal references to avoid taking sides. Ceri Davies wrote: > On Fri, Jul 15, 2005 at 12:23:33AM +0200, Michael Nottebrock wrote: >> On Friday, 15. July 2005 00:09, Ceri Davies wrote: >>> Disclaimer: I have not been following, nor do I wish to back up and >>> read, the argument. >> >> Perhaps following discussions like these more often would help avoiding our >> documentation becoming stale like that. > > Holy fuck, where did I ask for that? Perhaps documenting the odd > feature when it gets added would help too. Later. As entertaining as this has been, it doesn't seem useful for the people who write code and the people who try to document that code to argue. Some people are good at coding, some are good at documentation, and a few do both especially well. If you've written code and failed to document it properly, you should be thankful when someone figures your stuff out well enough to document it so that a normal user can use it. If you're changing code that already has documentation in a way that makes the documentation no longer correct, and you fail to change the documentation yourself, it's not particularly useful to expect the docs to magicly update themselves, now is it? -- -Chuck
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?42D7F708.2060007>