The 3rd Edition FreeBSD Handbook will be published in two volumes, each over 400 pages. Volume I (User Guide) will cover the basics, while Volume II (Administrator's Guide) will cover system administration and more advanced topics.
If you would like to get involved with the production of this edition, please send email to the -doc mailing list. Thanks!
| Task | Responsible | Last updated | Status |
|---|---|---|---|
| Create new callout images for the numbers 1 - 25 as the default images with the DocBook stylesheets only go from 1-9 and then fall back on text numbers. This looks bad when we have more than 9 callouts in the text, such as the Security Advisories section of the Security chapter. Update: Numbers up to 15 added from DocBook CVS. | &a.murray; | July 12, 2004 | &done; |
| Rewrite firewall section to cover pf, ipf and ipfw. | &a.trhodes; | July 22, 2004 | &inprogress; |
| Write a proper synopsis for the Vinum chapter. | &a.ceri;, via a patch from Kevin Kinsey | July 29, 2004 | &done; |
| Advanced Network Chapter is almost 100 pages and should be split up. Update: new Network Servers chapter split off separately. | &a.murray; | July 13, 2004 | &done; |
| Review recently added HTTP Server section. | -- | July 20, 2004 | ¬started; |
| Review recently added FTP Server section. | -- | July 20, 2004 | ¬started; |
| Add information about setting up a secure web server to the Apache section. Generating the certificate, getting the certificate signed, etc.. | &a.murray; | July 20, 2004 | ¬started; |
| Add a section about running a Windows file server with Samba to Network Servers chapter. | -- | July 20, 2004 | ¬started; |
| Update the DHCP section of the Network Servers chapter to describe omshell and recent DHCP 3.X features now in the base system. UPDATE: omshell is pretty technical and I don't think we really need to get into it in the Handbook? Thoughts? | -- | July 13, 2004 | &inprogress; |
| Information about running an FTP server should be added to the Network Servers chapter. | &a.murray; | July 21, 2004 | &done; |
| Add a type attribute to localhost URLs so that these can be omitted from the printed output. | &a.murray; | May 18, 2003 | &done; |
| Add <colspecs> to tables as necessary to enhance the print output. | &a.murray; | May 18, 2003 | &inprogress; |
| Remove all ASCII artwork | &a.murray; | May 18, 2003 | &done; |
| Update chapter on using modern versions of GNOME | &a.marcus; | May 18, 2003 | &done; |
| Fix cross-referencing tags to look better in the print output. | &a.murray; | May 18, 2003 | &inprogress; |
| Standardize spelling of technical terms | &a.trhodes; | May 18, 2003 | &inprogress; |
| Make sure all filenames, commands, applications, hostnames, etc are marked up properly | &a.blackend; | May 18, 2003 | &inprogress; |
| Update appendix of contributing authors. | &a.chern; | July 20, 2004 | &inprogress; |
| Update PPP/SLIP chapter | &a.trhodes; | May 18, 2003 | &done; |
| Clean up the IPSec section | &a.hmp;, &a.chern; | October 26, 2003 | &done; |
| Add simple illustrations at the beginning of each Part. | May 18, 2003 | ¬started; | |
| Add admonition graphics for Note, Caution, Warning, Tip. | &a.hrs; | May 18, 2003 | &inprogress; |
| Design the cover. | Ben Hansen | July 20, 2004 | &done; |
| Update content in introduction chapter for post 5.0 world. | May 18, 2003 | ¬started; | |
| Make front matter look better | &a.murray; | May 18, 2003 | &done; |
| Review the book for grammatical errors. | Everyone! | May 18, 2003 | &inprogress; |
| Implement automated spellchecker for entire Handbook. Chern wrote some Tcl scripts and posted them to doc@ around the time of the second edition work. This could be a starting point. | May 18, 2003 | ¬started; | |
| Make sure all section titles are capitalized properly | &a.ceri; | May 18, 2003 | &done; |
| Remove gratuitous Q/A sections in favor of more formal text. (see the end of the ports/packages chapter) | &a.trhodes; | May 18, 2003 | &inprogress; |
| Add more information about ACPI. | &a.trhodes; and &a.njl; | May 18, 2003 | &done; |
| Add information about Kerberos5 and adjust Kerberos4 information accordingly. | &a.trhodes; | May 18, 2003 | &done; |
| Update Preface. | &a.murray; | July 20, 2004 | &inprogress; |
| Update bibliography with newer editions, etc. | May 18, 2003 | ¬started; | |
| Add more indexterms throughout the book. Reorganize some existing indexterms. See the "make indexcheck" functionality for help finding areas of the book where indexterms are sparse. | May 18, 2003 | ¬started; | |
| Write an introduction for the Serial Communications chapter (note the big "XXX - Write me!" comment). The current Synopsis can probably be adapted for this. | May 19, 2003 | ¬started; | |
| The Mini-Cartridge section in the disks chapter still needs to be written. Update: section removed. | &a.murray; | July 20, 2004 | &done; |
| Add information about network configuration to the install chapter. | &a.trhodes; | May 18, 2003 | &done; |
| Add some documentation on cron(8). | &a.trhodes; | May 18, 2003 | &done; |
| Fill undefined glossary terms. | Everyone! | August 16, 2004 | ¬started; |
| Send everything to the printer. | &a.murray; | ¬started; |