From owner-cvs-doc@FreeBSD.ORG Sun Aug 17 10:40:41 2008 Return-Path: Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D75DB1065689; Sun, 17 Aug 2008 10:40:41 +0000 (UTC) (envelope-from gabor@kovesdan.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 8C15D8FC21; Sun, 17 Aug 2008 10:40:41 +0000 (UTC) (envelope-from gabor@kovesdan.org) Received: from localhost (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id C795814D6778; Sun, 17 Aug 2008 12:40:40 +0200 (CEST) X-Virus-Scanned: amavisd-new at t-hosting.hu Received: from server.mypc.hu ([127.0.0.1]) by localhost (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id zgorPr28+uCT; Sun, 17 Aug 2008 12:40:38 +0200 (CEST) Received: from [89.134.207.83] (catv-5986cf53.catv.broadband.hu [89.134.207.83]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 9656E14D6775; Sun, 17 Aug 2008 12:40:38 +0200 (CEST) Message-ID: <48A8001E.1000104@kovesdan.org> Date: Sun, 17 Aug 2008 12:40:30 +0200 From: Gabor Kovesdan User-Agent: Thunderbird 2.0.0.16 (Windows/20080708) MIME-Version: 1.0 To: Hiroki Sato References: <200808162142.m7GLgaAQ086124@repoman.freebsd.org> <20080817.073048.238614512.hrs@allbsd.org> In-Reply-To: <20080817.073048.238614512.hrs@allbsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: pgj@FreeBSD.org, doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/articles/committers-guide article.sgml doc/en_US.ISO8859-1/articles/releng article.sgml doc/en_US.ISO8859-1/books/developers-handbook/policies chapter.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 17 Aug 2008 10:40:42 -0000 Hiroki Sato ha scritto: > Gabor Pali wrote > in <200808162142.m7GLgaAQ086124@repoman.freebsd.org>: > > pg> pgj 2008-08-16 21:42:36 UTC > pg> > pg> FreeBSD doc repository > pg> > pg> Modified files: > pg> en_US.ISO8859-1/articles/committers-guide article.sgml > pg> en_US.ISO8859-1/articles/releng article.sgml > pg> en_US.ISO8859-1/books/developers-handbook/policies > pg> chapter.sgml > pg> Log: > pg> - Take the outdated sections of articles/contributors out of circulation > pg> in doc/ > pg> > pg> Discussed with: joel > pg> Reviewed by: joel > pg> Approved by: gabor (mentor) > > What is the reason why choosing not updating the article? I do not > think simply leaving the old description is a good idea, and we need > a discussion about which should be maintained before replacing the > existing links because currently administration.sgml and > contributors/ article have some duplicated information. > It was discussed a long ago in a thread started by Joel, and before this particular change, as well. Gabor sent a mail to doc@ with proposed changes and nobody objected in removing these parts. One of the other suggestions was to try to make one list and generate both the web pages and the article from that one. That might be a better solution, but the doc and the www tree should be able to build separately, so I think it would be complicated to implement. I think there are other overlapping parts, like &os; and the current release entities. Maybe it would make sense to separate them to a common part somehow and use it for the web and the doc? Gabor