From owner-freebsd-doc@FreeBSD.ORG Sat Jan 13 16:59:53 2007 Return-Path: X-Original-To: doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id AADE816A40F; Sat, 13 Jan 2007 16:59:53 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (vlsi00.si.noda.tus.ac.jp [133.31.130.32]) by mx1.freebsd.org (Postfix) with ESMTP id D9C6D13C45A; Sat, 13 Jan 2007 16:59:52 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p3089-ipbf506funabasi.chiba.ocn.ne.jp [124.100.58.89]) (authenticated bits=128) by mail.allbsd.org (8.13.1/8.13.4) with ESMTP id l0DGxcfN003855; Sun, 14 Jan 2007 01:59:50 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) (authenticated bits=0) by delta.allbsd.org (8.13.4/8.13.4) with ESMTP id l0DGwdPU000752; Sun, 14 Jan 2007 01:58:41 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sun, 14 Jan 2007 01:57:51 +0900 (JST) Message-Id: <20070114.015751.59745560.hrs@allbsd.org> To: joel@FreeBSD.org From: Hiroki Sato In-Reply-To: <1168633900.1082.38.camel@jesus.automatvapen.se> <1168562996.1100.42.camel@jesus.automatvapen.se> References: <1168562996.1100.42.camel@jesus.automatvapen.se> <20070112.201104.113738010.hrs@allbsd.org> <1168633900.1082.38.camel@jesus.automatvapen.se> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 5.1 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sun_Jan_14_01_57_51_2007_090)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV version 0.88.7, clamav-milter version 0.88.7 on gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH authentication, not delayed by milter-greylist-2.0.2 (mail.allbsd.org [133.31.130.32]); Sun, 14 Jan 2007 01:59:50 +0900 (JST) Cc: doc@FreeBSD.org Subject: Re: RFC: The end of the contributors article 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: Sat, 13 Jan 2007 16:59:53 -0000 ----Security_Multipart(Sun_Jan_14_01_57_51_2007_090)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Joel Dahl wrote in <1168633900.1082.38.camel@jesus.automatvapen.se>: jo> Fre 2007-01-12 klockan 20:11 +0900 skrev Hiroki Sato: jo> > It is good to make the contributors list up-to-date, but what is the jo> > benefit to move it to the www tree? And where is the source file? jo> jo> You'll get to see the source when I have something to show you. Thanks. I'll wait. jo> > I think issue we have for the list is that this sort of information jo> > is scattered in the doc/www tree and the scattered information is jo> > difficult to maintain (remember a case of the mirror site list). So jo> > I think the direction we should go is to have a directory for the jo> > developers, build a structure to pick up necessary information from jo> > it, and leave the maintenance to each developer (like pgpkey). jo> > Maintaining such a directory in an HTML page is not a good idea---if jo> > we have active maintainers of the list it will work, but it will not jo> > last long unfortunately. Since I could not find the source file of jo> > your proposed team.html I am not sure how this page was generated, jo> > but if it was done by hand let's take account of the maintenance jo> > issue first. jo> jo> I've been maintaining the contributors article for almost 1,5 year now, jo> in case you haven't noticed. This won't change anytime soon. Yes, I know. I do not doubt if your activity would change. The matter I am concerned about is simply moving the contributors list to an HTML page would not help to reuse/centralize such scattered information (for example, we have some duplicated information in pgpkeys-*.sgml and the committers-guide, too). To me, your proposed change is to update the list (yes, this is great. thanks a lot!) but there is no obvious reason to move all of the related information in the source file to the www tree. jo> - This information does not really belong in an article. Could you elaborate this? As mentioned in the previous mail, I think this information should be in an independent database file, not belong in either article or an HTML page in the www tree. -- | Hiroki SATO ----Security_Multipart(Sun_Jan_14_01_57_51_2007_090)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (FreeBSD) iD8DBQBFqQ+PTyzT2CeTzy0RAjjcAJ9mJoRdDeBcEYIWXZOmJwxj9rmoGACeJomM mjaoxc9fd7jWuPS+KPo/040= =0ACe -----END PGP SIGNATURE----- ----Security_Multipart(Sun_Jan_14_01_57_51_2007_090)----