Official Hats page is a wee bit out of date

Joel Dahl joel at FreeBSD.org
Sun Jun 4 07:30:45 UTC 2006


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.

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.

-- 
Joel




More information about the freebsd-doc mailing list