Here are the projects currently under way (or being actively - contemplated on the freebsd-doc mailing list). I have also included some - that have not really been talked about, but would probably be a - good idea. Each project lists the contact person for that - project (if I know who it is).
+ contemplated on the freebsd-doc mailing list).If you think you can contribute to any of these, please do not hesitate to stand up and be counted. You should talk to the @@ -34,26 +31,33 @@ FreeBSD-doc@FreeBSD.org.
The Documentation TODO list is an + up-to-date list of documentation issues that should be resolved. + This list is posted every month on the FreeBSD-doc@FreeBSD.org + mailing list. If you wish to help us to improve the FreeBSD + documentation set you should, at first, choose to work on one of + the TODO list items.
+Responsible: Murray Stokely <murray@FreeBSD.org>
- -Synopsis: This project is complete. The 3rd Edition - FreeBSD Handbook is available now as a 2 volume set from The FreeBSD Mall. Volume - 1 ISBN: 1-57176-327-9, Volume 2 ISBN: 1-57176-328-7.
- -The task list that we used during the development of this book - is still archived here for - posterity.
- -The second edition project task list is also still archived here. The second edition manuscript is - 653 pages, and the ISBN number is 1-57176-303-1. Thanks to - everyone who contributed. Read the full announcement here.
-Index work requires experience and anyone who works on this @@ -108,28 +91,12 @@ It is imperative to view the PostScript version of the Handbook after making any changes to indexterms as many errors, such as long words or deeply nested indexterms will break the two column - output there, or cause the page number to be listed as '???'.
+ output there, or cause the page number to be listed as ???.There is a script doc/share/misc/indexreport.pl which can be used to find areas of an SGML file where <indexterms> are sparse.
- -Responsible: FreeBSD-doc <FreeBSD-doc@FreeBSD.org>
- -Synopsis: A chapter about Firewalls has recently been - added to the FreeBSD Handbook. This new addition is very much a - work in progress and there are many grammatical and - presentational errors in the chapter. This chapter was - previously a large section in the Security chapter, so please - see the CVS history of security/chapter.sgml to see - some of the work that has been done over the past few months to - bring this addition more into line with the Doc Project Primer - and the rest of our documentation set. There is still a lot of - work to be done, and any and all help is appreciated.
-Responsible: - <doc@FreeBSD.org>
- -Synopsis:
-Responsible: @@ -276,255 +232,6 @@ and Hiten Pandya <hmp@FreeBSD.org>
Synopsis: Document kernel interfaces and functions.
- - -Synopsis: Write section 4 manual pages.
- -All drivers in FreeBSD should have a section 4 manual page, - but some do not yet.
- -| Task | -Description | -Responsible | -Last Updated | -Status | -
|---|---|---|---|---|
| New section 4 manual pages | -||||
| bs(4) | -WD33C93 SCSI driver | -- | 7 November 2003 | -&status.new; | -
| cm(4) | -SMC Arcnet network adapters | -&a.trhodes; | -21 June 2004 | -&status.done; | -
| cnw(4) | -NetWave AirSurfer Wireless LAN | -&a.brueffer; | -10 September 2004 | -&status.done; | -
| ct(4) | -WD33C93-based SCSI driver | -&a.non; | -21 November 2003 | -&status.wip; | -
| digi(4) | -DigiBoard intelligent serial card driver | -XXX | -7 December 2003 | -&status.done; | -
| esp(4) | -QLogic (?) SCSI controller found in Sun Machines | -&a.trhodes; | -21 June 2004 | -&status.done; | -
| hfa(4) | -HARP ATM driver | -&a.trhodes; | -6 August 2004 | -&status.done; | -
| idt(4) | -NICStar ATM Adapter | -&a.trhodes;, &a.bms; | -9 November 2003 | -&status.done; | -
| ips(4) | -IBM/Adaptec ServerRAID controller | -&a.trhodes; | -11 November 2003 | -&status.done; | -
| ncv(4) | -NCR 53C500 SCSI driver (PC-98) | -&a.trhodes; | -20 November 2003 | -&status.done; | -
| nsp(4) | -Workbit Ninja SCSI driver (PC-98) | -&a.non; | -24 November 2003 | -&status.done; | -
| nss(4) | -NEC PC-98 sound support | -- | 7 November 2003 | -&status.new; | -
| ofwcons(4) | -IEEE-1275 / Open Firmware | -- | 7 November 2003 | -&status.new; | -
| rc(4) | -Riscom/8 communication multiplexor driver | -&a.trhodes; | -21 June 2004 | -&status.done; | -
| sab(4) | -SAB82523 Dual UART driver | -&a.bms; | -6 December 2003 | -&status.done; | -
| snc(4) | -Nat. Semi. DP8393X NIC driver | -&a.trhodes; | -21 June 2004 | -&status.done; | -
| snd_emu10k1(4) | -Soundblaster Pro driver | -&a.trhodes;, &a.hmp; | -7 November 2003 | -&status.done; | -
| snd_mss(4) | -AD1848-compatible MSS/WSS driver | -&a.joel; | -10 October 2005 | -&status.done; | -
| snd_sb8(4) | -Creative SoundBlaster (pre-16) driver | -- | 21 October 2005 | -&status.new; | -
| snd_sb16(4) | -Creative SoundBlaster16 driver | -- | 21 October 2005 | -&status.new; | -
| uaudio(4) | -USB Audio driver | -&a.hmp; | -10 November 2003 | -&status.done; | -
| wdc(4) | -- | &a.rushani; | -8 November 2003 | -&status.done; | -
| wds(4) | -WD7000 SCSI driver | -- | 24 August 2004 | -&status.new; | -
| xrpu(4) | -Xilinx FPGA/RPU driver | -- | 7 November 2003 | -&status.new; | -
| zs(4) | -Zilog UART driver | -- | 7 November 2003 | -&status.new; | -
| Legend | -|
|---|---|
| &status.new; | -Not yet started | -
| &status.blocked; | -Blocked awaiting completion of another task | -
| &status.wip; | -Work in progress | -
| &status.done; | -Task completed | -
| &status.n-a; | -Not planned | -