March 2006 doc TODO list
Marc Fonvieille
blackend at FreeBSD.org
Mon Mar 6 15:10:04 UTC 2006
Hello,
Here's the March 2006 doc TODO list.
We invite everyone to pick up a task or send PRs, and help us to
improve our documentation set. If you want to work (grab the
responsability) on a listed problem just raise your hand.
This list is also available on the FreeBSD.org site:
http://www.freebsd.org/docproj/todo.html
---
FreeBSD Documentation Project TODO list
This is a list of documentation issues that need to be resolved. If you have
any updates for this list, please e-mail doceng at FreeBSD.org.
Handbook Items
Issue Status Responsible Desired Description
Deadline
The installation chapter
mostly covers FreeBSD 4.X
installation. The current
information is often
Installation outdated and not accurate
chapter Ceri Davies, For for 5.X, 6.X and 7.X. We
needs to be Not done Giorgos Keramidas 6.1-RELEASE also have to think about
updated installation on various
platforms. This should be
done under re@ team
responsability since the
installation notes have to
be updated as well.
While this chapter covers
Printing in a very accurate way the
chapter configuration of a printer
lacks a under FreeBSD, a quick and
quick and Not done easy printer setup should
easy setup be documented, i.e.,
example something describing the
installation and use of
apsfilter or equivalent.
Nowadays printers use the
USB printers Not done USB interface, the printing
chapter may need to be
updated on this point.
The merge of http://
www.freebsdmall.com/~loader
For /en_US.ISO8859-1/articles/
Wireless Not done Murray Stokely 6.1-RELEASE wireless/article.html in
the current wireless
section should be done
quickly.
IPsec For This section still shows
section Not done 6.1-RELEASE the use of gifconfig(4)
which is 4.X only.
One should check if we need
For to update the sound section
USB audio Not done 6.1-RELEASE for USB devices or if the
current guidances are still
correct with these devices.
This section is really
The outdated and needs a
Emergency serious "facelifting." We
Restore Not done must show how to restore a
Procedure system using the livefs
section from disc1. The rescue
(16.12.8) system should also be
covered.
Backup Backing up on optical media
Basics Not done Murray Stokely (CD/DVD) should be
(16.12) presented.
The use of Makefile
Electronic facilities should be
mail chapter Not done introduced for the sendmail
configuration instead of
the old outdated way.
The configuration of inetd
inetd Done Ceri Davies For changed a bit in 6.X, one
6.1-RELEASE should check if the related
section is still correct.
The bsnmpd daemon is quite
new and its configuration
may be complex. The minimal
bsnmpd Not done common settings should be
introduced in a section of
the Network Servers
chapter.
Website
Issue Status Responsible Desired Description
Deadline
Add the new logo on our web site layout
New logo Not done Jun and create a logo page displaying, and
Kuriyama providing information on right logo
usage.
After the introduction of new layout,
many persons reported a font size or
Rendering Not done rendering problems under some browsers
issue configurations and screen resolutions.
These problems should be investigated
and fixed. Reference: www/91539
Manual Pages
Issue Status Responsible Desired Description
Deadline
bs(4) Not done New manual page needed for the WD33C93
SCSI driver
nss(4) Not done New manual page needed for the NEC
PC-98 sound support
ofwcons Not done New manual page needed for the
(4) IEEE-1275 / Open Firmware
snd_sb8 Not done New manual page needed for the Creative
(4) SoundBlaster (pre-16) driver
snd_sb16 Not done New manual page needed for the Creative
(4) SoundBlaster16 driver
wds(4) Not done New manual page needed for the WD7000
SCSI driver
xrpu(4) Not done New manual page needed for the Xilinx
FPGA/RPU driver
zs(4) Not done New manual page needed for the Zilog
UART driver
Other Documentations Needs
Issue Status Responsible Desired Description
Deadline
The CUPS system is more and more
used, it would be interesting to
have an extensive article in our
CUPS Not done documentation set. This article
should cover CUPS installation and
configuration (with examples of
local and network printers).
We may want to think about the need
NanoBSD Not done of a documentation: Handbook section
and/or manual page (this latter
seems to be mandatory) for NanoBSD.
The FreeBSD Architecture Handbook is
Architecture Not done lacking in content, please help us
Handbook finish this book in writting or
updating some chapters.
Documentation Toolchain Items
Issue Status Responsible Desired Description
Deadline
SGML/XML Add more localization support for
infrastructure Not done Hiroki Sato XML documentation in the doc and
update www tree.
SGML/XML Use SGML/XML catalog for external
infrastructure Not done Hiroki Sato file reference for consistency.
update
SGML/XML Add standard entity reference
infrastructure Not done Hiroki Sato (such as à) support in XML/
update XSLT documentation.
Legal Notices | (C) 1995-2006 The FreeBSD Project. All rights reserved.
---
Marc for doceng@
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20060306/fceea6e6/attachment.sig>
More information about the freebsd-doc
mailing list