Stuart Henderson wrote on Thu, Jun 09, 2011 at 09:21:38PM +0000:

> Seriously, if whoever "maintains" openbsd-wiki.org is reading,
> do us all a favour and take it offline unless you have time to look
> after it...

Even if you have the time to maintain it,
take it offline all the same.
Your time is better spent helping nick@ to improve the FAQ
and helping jmc@ to improve the manuals,
because there you don't start from scratch
and users actually find your documentation.
And it is checked by developers for relevance and accuracy
and kept up to date.

To re-iterate what i said here:

http://www.openbsd.org/papers/bsdcan11-mandoc-openbsd.html (page 2)

"Make documentation easily accessible:
 Have it at as few places as possible,
   and as much as possible at one single place.
 In OpenBSD, almost all documentation is manuals,
   and the little that doesn't fit there is all in the FAQ."

Well, there's a bit more, but not much.
Like /usr/local/share/doc/pkg-readmes/.

We most definitely do *not* want documentation scattered around
half the web, ending up with most of it utterly outdated and
unmaintained.

Reply via email to