Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 12 Jun 2003 09:58:16 -0400
From:      "Michael W . Lucas" <mwlucas@blackhelicopters.org>
To:        doc@FreeBSD.org
Subject:   attributions in FAQ
Message-ID:  <20030612095816.A27046@blackhelicopters.org>

next in thread | raw e-mail | index | archive | help
Hi folks,

As some of you might notice, I'm working on the FAQ intensively for a
few days.  A couple things I've noticed:

We have one and only one section, "installation", that has an author
listed.  I don't think that FAQ sections really have authors; they're
not like the Handbook.  IIRC, most of the useful information in this
section went into the Handbook anyway.  If we want authors listed, we
should put them on either all the sections, or on individual
questions, not just on one section that now sticks out like a sore
toe.

Also, the "acknowledgements" section is woefully obsolete.  We have
jkh listed, when he made only two commits to the current FAQ.  While I
have the highest respect for Peter da Silva, he has not been the FAQ
typing machine slavey since the dark ages.  Wollman hasn't committed
to the current FAQ.  Meanwhile, current contributors go
unacknowledged.

I am well aware that these people put in a huge amount of work, mind
you, and we should not dismiss them in favor of us young turks who
have only been active since 1999 or so.  That's a definite slap in the
face to our past supporters, and those who gave us something to work
on.

I believe that the credits section is essentially unmaintainable.  One
of these days, those young punks like trhodes or (gasp) hmp may be the
old farts, when I've have moved on to maintaining libembezzle or
something.

My suggestion is that we credit people in individual questions where
necessary, particularly where we quote emails and suchlike, and delete
the acknowledgements page entirely.

Comments?

==ml

-- 
Michael Lucas		mwlucas@FreeBSD.org, mwlucas@BlackHelicopters.org
http://www.BlackHelicopters.org/~mwlucas/

           Absolute OpenBSD:   http://www.AbsoluteOpenBSD.com/



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030612095816.A27046>