Official Hats page is a wee bit out of date

Simon L. Nielsen simon at FreeBSD.org
Sun Jun 4 20:46:48 UTC 2006


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 
> > http://www.freebsd.org/doc/en_US.ISO8859-1/books/dev-model/official-hats.html 
> > 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:
> 
> 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/
> 
> 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...

-- 
Simon L. Nielsen
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20060604/f3ee288c/attachment.sig>


More information about the freebsd-doc mailing list