From owner-cvs-doc@FreeBSD.ORG Mon Aug 18 20:49:25 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 C8F6C106566B; Mon, 18 Aug 2008 20:49:25 +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 6D1AC8FC22; Mon, 18 Aug 2008 20:49:25 +0000 (UTC) (envelope-from gabor@kovesdan.org) Received: from localhost (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 45C1714D6B86; Mon, 18 Aug 2008 22:49:24 +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 91aril3kHsKI; Mon, 18 Aug 2008 22:49:22 +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 C440C14D6B81; Mon, 18 Aug 2008 22:49:21 +0200 (CEST) Message-ID: <48A9E040.7050104@kovesdan.org> Date: Mon, 18 Aug 2008 22:49:04 +0200 From: Gabor Kovesdan User-Agent: Thunderbird 2.0.0.16 (Windows/20080708) MIME-Version: 1.0 To: "Simon L. Nielsen" References: <200808162142.m7GLgaAQ086124@repoman.freebsd.org> <20080817.073048.238614512.hrs@allbsd.org> <48A75B1A.7060809@FreeBSD.org> <20080817.204750.78468138.hrs@allbsd.org> <20080818153942.GH1172@zaphod.nitro.dk> In-Reply-To: <20080818153942.GH1172@zaphod.nitro.dk> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: pgj@FreeBSD.org, Hiroki Sato , cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org, doc-committers@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 20:49:25 -0000 Simon L. Nielsen ha scritto: > 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. > Yes, SVN would be a nice idea! As for the diversity, I'm planning to work on doc to redesign it a bit using XML and newer DocBook and this will reduce the diversity. Of course, not completely as HTML and DocBook tags are quite different, but having everything in XML markup everything will be more uniform. Your point have sense, but personally I like the idea of having web in the language directories, because in this way the structure seems more consistent to me. You just enter the directory and you see the types of documentation, which could be currently: books, articles, web, slides, flyer. Gabor