From owner-cvs-doc@FreeBSD.ORG Sun Aug 17 12:29:04 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 22F7B1065677 for ; Sun, 17 Aug 2008 12:29:04 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from qb-out-0506.google.com (qb-out-0506.google.com [72.14.204.234]) by mx1.freebsd.org (Postfix) with ESMTP id BD6D08FC0C for ; Sun, 17 Aug 2008 12:29:03 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by qb-out-0506.google.com with SMTP id e34so1996694qbe.35 for ; Sun, 17 Aug 2008 05:29:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; bh=TIVcl2BFxlmAiJXqFUQvA5sqJR3iOuhRVrK7OepfDYM=; b=hsH5xaBg3dVZGSS4Ob4cBd+WGDB5cgN3WmP1p2maOSlo1cP7YC/TTAIK6PicYaMh3z RYjZJGEKUt/+NUQUhqHJkZXTDjp4Dptvkh9AK37K/fyOrv8pIPZquH9womGrbumB4Ars c3/Ayr4AK79cJa6av/03wRvkT1zoaMgbe3tH8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; b=MztJNQoYT4lU9b1IYjR+9Jef5jVf8rY1kzDE3zChEOtaHenyVTZyZ5NiJujc2LDs9G /liw35hfCfP+NLfEQzDJu9raXmdoJprlAr3BrZ1RrrJDqFLPRWBTlMYlQ1B/YyHXm+Dq iQ8IaR7GkXDkpvcRJksMjVWFNWtjIXo+HibtE= Received: by 10.181.32.15 with SMTP id k15mr2566149bkj.84.1218976142383; Sun, 17 Aug 2008 05:29:02 -0700 (PDT) Received: from ?192.168.0.1? ( [80.99.205.120]) by mx.google.com with ESMTPS id g28sm6345181fkg.8.2008.08.17.05.29.00 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 17 Aug 2008 05:29:01 -0700 (PDT) Message-ID: <48A8198B.2010509@FreeBSD.org> Date: Sun, 17 Aug 2008 14:28:59 +0200 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.14 (X11/20080521) MIME-Version: 1.0 To: Hiroki Sato References: <200808162142.m7GLgaAQ086124@repoman.freebsd.org> <20080817.073048.238614512.hrs@allbsd.org> <48A75B1A.7060809@FreeBSD.org> <20080817.204750.78468138.hrs@allbsd.org> In-Reply-To: <20080817.204750.78468138.hrs@allbsd.org> X-Enigmail-Version: 0.95.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Cc: gabor@kovesdan.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 12:29:04 -0000 Hiroki Sato wrote: > moving only the team information into www does not agree with the > reason why we have article/contributors. I see. Well... According to revision 1.1 [1] (by murray and nik): "Combine parts of Chapter 21 and Appendix D from the FreeBSD Handbook into a separate 'Contributors' article so that everything is in one place. This was done for various reasons : * This information is way out of scope for the Handbook. * When we talk about "Contributors" to FreeBSD or developed by "A large team of individuals" on the web site we can point the user to a complete document on our web page rather than two separate chapters in the Handbook. * We can create a plain-text 'CREDITS' file from this SGML and put it in /usr/share/misc or similar for all FreeBSD installs if that is desired." It was full of outdated and out of synch information, but there is always place for ideas for a better a documentation, I think. > 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. I support it. When do you think this process could be started? Are there any actual obstacles? > what do you think about adding files including who it is on per > developer basis? [..] 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. I am fond of this kind of approach ;) For example, mentors could only send a file like you attached to their mentees to fill up in advance. I would be happy to see something like this. What do you think will be needed to implement this and get the ball rolling? :g [1] http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/articles/contributors/article.sgml?f=h;rev=1.1