From owner-freebsd-doc@FreeBSD.ORG Sat Jan 13 08:53:46 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 EAEBA16A412 for ; Sat, 13 Jan 2007 08:53:45 +0000 (UTC) (envelope-from joel@FreeBSD.org) Received: from av9-1-sn3.vrr.skanova.net (av9-1-sn3.vrr.skanova.net [81.228.9.185]) by mx1.freebsd.org (Postfix) with ESMTP id 7FDFE13C465 for ; Sat, 13 Jan 2007 08:53:45 +0000 (UTC) (envelope-from joel@FreeBSD.org) Received: by av9-1-sn3.vrr.skanova.net (Postfix, from userid 502) id 1DFEC391DF; Sat, 13 Jan 2007 09:53:44 +0100 (CET) Received: from smtp3-2-sn3.vrr.skanova.net (smtp3-2-sn3.vrr.skanova.net [81.228.9.102]) by av9-1-sn3.vrr.skanova.net (Postfix) with ESMTP id C4F9137F59; Sat, 13 Jan 2007 09:53:43 +0100 (CET) Received: from [192.168.1.199] (81-234-214-163-no68.tbcn.telia.com [81.234.214.163]) by smtp3-2-sn3.vrr.skanova.net (Postfix) with ESMTP id A735437E42; Sat, 13 Jan 2007 09:53:43 +0100 (CET) From: Joel Dahl To: Hiroki Sato In-Reply-To: <20070112.201104.113738010.hrs@allbsd.org> References: <1168562996.1100.42.camel@jesus.automatvapen.se> <20070112.201104.113738010.hrs@allbsd.org> Content-Type: text/plain Date: Fri, 12 Jan 2007 21:31:39 +0100 Message-Id: <1168633900.1082.38.camel@jesus.automatvapen.se> Mime-Version: 1.0 X-Mailer: Evolution 2.8.2.1 FreeBSD GNOME Team Port Content-Transfer-Encoding: 7bit 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 08:53:46 -0000 Fre 2007-01-12 klockan 20:11 +0900 skrev Hiroki Sato: > Joel Dahl wrote > in <1168562996.1100.42.camel@jesus.automatvapen.se>: > > jo> Today I decided to finally do what I've been planning to do for a long > jo> time: move stuff out of the contributors article and instead place it > jo> under www/. > jo> > jo> I started with the teams etc and you can see the results here (nowhere > jo> near finished yet though): > jo> > jo> http://people.freebsd.org/~joel/wii/team.html > jo> > jo> So, why bother anyway? Well: > jo> > jo> - Better information about what the different teams do and what their > jo> responsibilities are. Our developers are generally very confused > jo> when it comes to finding the right person to talk to, for example > jo> when requesting repo-copies or new perforce accounts etc. This will > jo> hopefully improve the situation somewhat. > jo> - The translation teams generally don't translate the contributors > jo> article since it doesn't seem to be worth the effort. Hopefully > jo> this will change now, since this can be quite important information > jo> even for non-English speaking people. > jo> - Email addresses are not completely visible anymore. > jo> - This information does not really belong in an article. > jo> - This is more up-to-date and includes a lot more teams etc. > > It is good to make the contributors list up-to-date, but what is the > benefit to move it to the www tree? And where is the source file? You'll get to see the source when I have something to show you. > I think issue we have for the list is that this sort of information > is scattered in the doc/www tree and the scattered information is > difficult to maintain (remember a case of the mirror site list). So > I think the direction we should go is to have a directory for the > developers, build a structure to pick up necessary information from > it, and leave the maintenance to each developer (like pgpkey). > Maintaining such a directory in an HTML page is not a good idea---if > we have active maintainers of the list it will work, but it will not > last long unfortunately. Since I could not find the source file of > your proposed team.html I am not sure how this page was generated, > but if it was done by hand let's take account of the maintenance > issue first. I've been maintaining the contributors article for almost 1,5 year now, in case you haven't noticed. This won't change anytime soon. -- Joel