os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add a todo list for the third printed edition of the FreeBSD Handbook.

Browse source
This commit is contained in:
Murray Stokely 2003-05-18 20:49:48 +00:00
parent 619e80db24
commit 3899a4a293
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=16963
2 changed files with 194 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
en/docproj/Makefile
View file

@ -1,4 +1,4 @@
# $FreeBSD: www/en/docproj/Makefile,v 1.8 2000/11/07 04:05:14 kuriyama Exp $
# $FreeBSD: www/en/docproj/Makefile,v 1.9 2001/07/31 00:24:23 murray Exp $
.if exists(../Makefile.conf)
.include "../Makefile.conf"
@ -10,6 +10,7 @@
DOCS= current.sgml
DOCS+= doc-set.sgml
DOCS+= handbook.sgml
DOCS+= handbook3.sgml
DOCS+= sgml.sgml
DOCS+= submitting.sgml
DOCS+= who.sgml

192
en/docproj/handbook3.sgml Normal file
View file

@ -0,0 +1,192 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD Documentation Project: Handbook 3rd Edition">
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
<!ENTITY done "<font color='green'>Done</font>">
<!ENTITY inprogress "<font color='blue'>In Progress</font>">
<!ENTITY notstarted "<font color='red'>Not Started</font>">
]>
<html>
&header;
<h1>FreeBSD Handbook 3rd Edition</h1>
<p>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.</p>
<p>If you would like to get involved with the production of this
edition, please send email to the -doc mailing list. Thanks!</p>
<table border=1>
<tr bgcolor="blue"><th><font color="white">Task</font></th><th><font
color="white">Responsible</font></th><th><font color="white">Last
updated</font></th><th><font color="white">Status</font></th></tr>
<tr>
<td>Add a type attribute to localhost URLs so that these can be
ommitted from the printed output.</td>
<td>Murray</td>
<td>May 18, 2003</td>
<td>&done;</td>
</tr>
<tr>
<td>Add &lt;colspecs&gt; to tables as necessary to enhance the print output.</td>
<td>Murray</td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>Remove all ASCII artwork</td>
<td>Murray</td>
<td>May 18, 2003</td>
<td>&done;</td>
</tr>
<tr>
<td>Update chapter on using modern versions of GNOME</td>
<td>Joe Marcus</td>
<td>May 18, 2003</td>
<td>&done;</td>
</tr>
<tr>
<td>Fix cross-referencing tags to look better in the print
output.</td>
<td>Murray</td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>Standardize spelling of technical terms</td>
<td></td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>Make sure all filenames, commands, applications, hostnames, etc
are marked up properly</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Update appendix of contributing authors.</td>
<td>Chern</td>
<td>May 18, 2003</td>
<td>&notstarted;;</td>
</tr>
<tr>
<td>Update PPP/SLIP chapter</td>
<td>Tom Rhodes</td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>Clean up the IPSec section</td>
<td>Hiten Pandya</td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>Add simple illustrations at the beginning of each Part.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Add admonition graphics for Note, Caution, Warning, Tip.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Design the cover.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Update content in introduction chapter for post 5.0 world.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Make front matter look better</td>
<td>Murray</td>
<td>May 18, 2003</td>
<td>&done;</td>
</tr>
<tr>
<td><strong>Review the book for grammatical errors.</strong></td>
<td>Everyone!</td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>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.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Make sure all section titles are capitalized properly</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Remove gratuitous Q/A sections in favor of more formal
text. (see the end of the ports/packages chapter)</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Update Preface.</td>
<td>Murray</td>
<td>May 18, 2003</td>
<td>&inprogress;</td>
</tr>
<tr>
<td>Write Foreword.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Update bibliography with newer editions, etc.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>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.</td>
<td></td>
<td>May 18, 2003</td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Add information about network configuration to the install chapter.</td>
<td></td>
<td></td>
<td>&notstarted;</td>
</tr>
<tr>
<td>Send everything to the printer.</td>
<td>Murray</td>
<td></td>
<td>&done;</td>
</tr>
</table>
</body>
</html>