From owner-freebsd-doc@FreeBSD.ORG Fri Jul 15 17:50:19 2005 Return-Path: X-Original-To: doc@freebsd.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E468116A41C; Fri, 15 Jul 2005 17:50:19 +0000 (GMT) (envelope-from cswiger@mac.com) Received: from pi.codefab.com (pi.codefab.com [199.103.21.227]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7F74A43D45; Fri, 15 Jul 2005 17:50:19 +0000 (GMT) (envelope-from cswiger@mac.com) Received: from localhost (localhost [127.0.0.1]) by pi.codefab.com (Postfix) with ESMTP id E9CE55C99; Fri, 15 Jul 2005 13:50:18 -0400 (EDT) Received: from pi.codefab.com ([127.0.0.1]) by localhost (pi.codefab.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 36989-04; Fri, 15 Jul 2005 13:48:53 -0400 (EDT) Received: from [192.168.1.3] (pool-68-161-54-113.ny325.east.verizon.net [68.161.54.113]) by pi.codefab.com (Postfix) with ESMTP id 07DF85C44; Fri, 15 Jul 2005 13:48:52 -0400 (EDT) Message-ID: <42D7F708.2060007@mac.com> Date: Fri, 15 Jul 2005 13:48:56 -0400 From: Chuck Swiger Organization: The Courts of Chaos User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.8) Gecko/20050511 X-Accept-Language: en-us, en MIME-Version: 1.0 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> In-Reply-To: <20050714222749.GD80131@submonkey.net> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: amavisd-new at codefab.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 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 15 Jul 2005 17:50:20 -0000 [ ...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