afabianaustin.rr.com
Date: Thu Nov 11 2004 - 13:10:28 CST

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

I'd like seeing complete/up-to-date documentation in much the style
of the 4.4BSD docs in /usr/share/doc, maintained in some more modern
format like DocBook. There is a lot of information in disparate
places that just about everyone would benefit from seeing gathered
to together. One thing I think it would be very good to have a
clear picture of before getting too deep is just what the finished
product is supposed to look like; what level of user it's aimed at,
and how easy it will be to search/nagivate. The content itself
seems to be around if you look, so I think this thing stands to
give the most benefit in organization and nagivation of available
information. OpenBSD is already really good about documenting
things accurately at a technical level, and OpenBSD has no reason
to duplicate the documentation of 3rd party projects. Somewhere
in the middle, there's room for useful documentation of various
sorts, like mini-HOWTO's on very particular subjects (say, running
OpenOffice using Linux emulation), but I somehow envision the hard
part as keeping it from blending together into an useless mish-mash
of rehash.

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]