From owner-cvs-doc@FreeBSD.ORG Mon Aug 18 15:55:12 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 C2ABD106568F; Mon, 18 Aug 2008 15:55:12 +0000 (UTC) (envelope-from simon@benji.nitro.dk) Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38]) by mx1.freebsd.org (Postfix) with ESMTP id 69F878FC73; Mon, 18 Aug 2008 15:55:06 +0000 (UTC) (envelope-from simon@benji.nitro.dk) Received: from benji.nitro.dk (unknown [192.168.3.39]) by mx.nitro.dk (Postfix) with ESMTP id 2B36E1E8C04; Mon, 18 Aug 2008 15:39:45 +0000 (UTC) Received: by benji.nitro.dk (Postfix, from userid 2000) id 11CCE100D2; Mon, 18 Aug 2008 16:39:44 +0100 (BST) Date: Mon, 18 Aug 2008 16:39:43 +0100 From: "Simon L. Nielsen" To: Hiroki Sato Message-ID: <20080818153942.GH1172@zaphod.nitro.dk> References: <200808162142.m7GLgaAQ086124@repoman.freebsd.org> <20080817.073048.238614512.hrs@allbsd.org> <48A75B1A.7060809@FreeBSD.org> <20080817.204750.78468138.hrs@allbsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20080817.204750.78468138.hrs@allbsd.org> User-Agent: Mutt/1.5.18 (2008-05-17) Cc: gabor@kovesdan.org, 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: Mon, 18 Aug 2008 15:55:12 -0000 On 2008.08.17 20:47:50 +0900, Hiroki Sato wrote: > Gabor Kovesdan wrote > in <48A8001E.1000104@kovesdan.org>: > > ga> separately, so I think it would be complicated to implement. I think > ga> there are other overlapping parts, like &os; and the current release > ga> entities. Maybe it would make sense to separate them to a common part > ga> somehow and use it for the web and the doc? > > Yes, I think we should go for that direction somehow. And in a long > term, maybe we should merge www and doc into a single repository > (like www/en -> doc/en_US.ISO8859-1/htdocs or so) because of making > reuse of information easier. Currently www build heavily depends on > doc tree (www only build can be done but the result is not complete), > so I think the merged repository with an option for htdocs-only build > would also work without a serious problem. I have no general problem with merging www and doc closer (might be done while considering moving to svn?) and fully requiring having both for build of either, but having e.g. www/en as a deep subdir of doc/ seems like a rather bad idea to me. The web site and and doc/ are rather differnet beast wrt. how you write content so I see no problem having it in seperate top level directories. > BTW, for teams/hats related information, what do you think about > adding files including who it is on per developer basis? An > experimental one for showing the concept is attached. It includes > pgpkey, hats, commit bit array, mentors, and location. Most of > member descriptions of teams/hats can be generated from the files, > and also the traditional first commit by a new committer can be > simplified. Generally, I think it would be neat (and I looked a bit of doing it a few years ago), but I must say I'm not sure if doing it is really worth the trouble compared to just making sure we don't have duplication of the information. That said, if somebody does it I'm certainly not generally against it (considering my below point). For some parts of our current site I think some of the XSLT magic is a bit to magic and hard to understand, so I'm a but conserned going too much further in that direction... -- Simon L. Nielsen