[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Reviving the Debian FAQ

[ Note: This mail was originally sent to -doc, as I have only received one
answer so far I'm resending to -devel in order to get more people to help out
with this documentation effort ]

The Debian FAQ [0] has been, unfortunately, unmaintained for quite some time 
and needs a thorough review.

I updated information in the FAQ in preparation for the sarge release when I
noticed that it was out of date and incomplete [1].  After the release
I've been fixing some other obsolete sections and fixing some of
its long-standing bugs, uploading new revisions of the doc-debian package
in the process.

It would be really great if other DDs could review the FAQ fully and
point out:

a- missing FAQ items, that is, things that people commonly ask about Debian 
   that are not there and we should write about.

b- obsolete FAQ items, i.e., items in the FAQ that are no longe relevant and
   should be removed or rewritten.

c- incorrect FAQ items, i.e., items that should be rewritten or fixed because
   they contain innacurate statements.
I've fixed some of a), b) or c) with the help of Santiago Vila who is doing
the Spanish translation but more peer review is needed here. Patches, of
course, are prefered, but if you don't have time for a patch, comments are
also welcome.

Yes, I know there are some documents which are better than the FAQ for some
issues (such as the Installation Manual or the Debian reference). But there are
several reasons why I believe this document should be kept up to date: it's 
included in the official Debian CDs (it's one of the few documents provided 
there), it's included in all the official Debian mirrors (under /doc/), 
and many users (well, those that RTFM, that is) might go read it since 
it's listed as the first "User document" currently in our web page.

Thanks for your help!



[0] http://www.debian.org/doc/user-manuals#faq
[1] Message-ID: <20050603004819.GA17340@dat.etsit.upm.es>
[2] http://www.debian.org/doc/manuals/reference/ch-system.en.html

Attachment: signature.asc
Description: Digital signature

Reply to: