Re: The OpenBSD Documentation (FAQ)

[afabian_(_at_)_austin_(_dot_)_rr_(_dot_)_com]

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.