From owner-freebsd-doc@FreeBSD.ORG Sun Jun 4 20:46:33 2006 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C9ADE16AE9A; Sun, 4 Jun 2006 20:46:33 +0000 (UTC) (envelope-from simon@zaphod.nitro.dk) Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4E80A43D45; Sun, 4 Jun 2006 20:46:33 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: from zaphod.nitro.dk (unknown [192.168.3.18]) by mx.nitro.dk (Postfix) with ESMTP id 029942D4877; Sun, 4 Jun 2006 20:44:59 +0000 (UTC) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 2E2D911420; Sun, 4 Jun 2006 22:46:32 +0200 (CEST) Date: Sun, 4 Jun 2006 22:46:32 +0200 From: "Simon L. Nielsen" To: Joel Dahl Message-ID: <20060604204631.GE1099@zaphod.nitro.dk> References: <20060603235511.F57378@znfgre.qbhto.arg> <1149406234.677.15.camel@localhost> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="MnLPg7ZWsaic7Fhd" Content-Disposition: inline In-Reply-To: <1149406234.677.15.camel@localhost> User-Agent: Mutt/1.5.11 Cc: freebsd-doc@freebsd.org, Doug Barton Subject: Re: Official Hats page is a wee bit out of date 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: Sun, 04 Jun 2006 20:46:48 -0000 --MnLPg7ZWsaic7Fhd Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2006.06.04 09:30:34 +0200, Joel Dahl wrote: > On Sat, 2006-06-03 at 23:56 -0700, Doug Barton wrote: > > I can take a pass at this if no one else gets around to it, but=20 > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/dev-model/official-hat= s.html=20 > > is not tracking reality atm. IMO it should be marked as "at the time of this writing, see XXX" in that document, or names should be removed. > Part of the problem is that we duplicate info about various teams, hats > and responsibilities everywhere in our docs, which makes them a PITA to > update. For example, if we change security-officer, the following docs > needs an update: >=20 > www/en/developers.sgml > www/en/security/security.sgml > doc/en_US.ISO8859-1/articles/contributors/ > doc/en_US.ISO8859-1/articles/committers-guide/ > doc/en_US.ISO8859-1/books/dev-model/ >=20 > So, when a team/hat changes, you need to update at least 3-5 documents, > which is way too much. One, or perhaps two, should be enough. Yes, this has been a problem for years. Someone(tm) should use the big axe and nuke all, but max two places like you say. That said, hrs said he was working on some more intelligent user information managent (came up recently with sharing of user data between www/ and doc/), so perhaps this may be able to set each hat once... --=20 Simon L. Nielsen --MnLPg7ZWsaic7Fhd Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.3 (FreeBSD) iD8DBQFEg0anh9pcDSc1mlERAvWTAKCbGDGmkorTe4QumHqindZLcL3ZdwCbBB5o 6NmM4E8iCf0M4N0tAScJtN8= =DAn0 -----END PGP SIGNATURE----- --MnLPg7ZWsaic7Fhd--