attributions in FAQ

Michael W . Lucas mwlucas at blackhelicopters.org
Thu Jun 12 13:58:18 UTC 2003


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 at FreeBSD.org, mwlucas at BlackHelicopters.org
http://www.BlackHelicopters.org/~mwlucas/

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



More information about the freebsd-doc mailing list