Date: Wed, 04 May 2005 09:44:18 -0500 From: Trevor Sullivan <pcgeek86@gmail.com> To: "Ryan J. Cavicchioni" <ryan.cavicchioni@gmail.com> Cc: freebsd-questions@freebsd.org Subject: Re: The FreeBSD Handbook, in Wiki form. Message-ID: <4278DFC2.5060109@gmail.com> In-Reply-To: <4278CF78.10801@gmail.com> References: <781e2bc0050503170031a960fd@mail.gmail.com> <20050504001546.GA64854@xor.obsecurity.org> <781e2bc005050317295898d640@mail.gmail.com> <4278CF78.10801@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Ryan J. Cavicchioni wrote: > I would love to see a wiki for FreeBSD. I think that it would be > really beneficial for the project. It would take some work to > establish it but if there were enough participants, it could turn > into a very robust documentation project. Some hard work would be > required to make the wiki healthy and to police it but the spirit > of a wiki is many users reviewing each other. > > Benjamin Keating wrote: > >> A wiki would eliminate that bottle neck (PR). Some parts are out >> of date. Others fail to mention FAQ , etc. that could really >> help. For instance, the NAT/DHCP articles could easily include a >> 'typical home user' HOWTO rather then tricking the user into >> reading that one line where it says you have to recompile your >> kernel with IPFIREWALL support. >> >> Things like that bring noise to this mailing list. Idon't know >> about you but I'd rather just add my new found info to the site >> rather find a PR addy, submit it and wait for it to be added. We >> have software that does this now. Lets use it! :) >> >> - bpk >> >> On 5/3/05, Kris Kennaway <kris@obsecurity.org> wrote: >> >>> On Tue, May 03, 2005 at 05:00:06PM -0700, Benjamin Keating >>> wrote: >>> >>>> Is there anything being done to help keep the handbook just a >>>> little more updated? It's a great handbook, if it's content >>>> wasn't so out of date. >>> >>> What is out of date? >>> >>> Generally, if you want to improve something in the handbook, >>> just submit a PR. >>> >>> Kris >>> >>> >>> >> _______________________________________________ >> freebsd-questions@freebsd.org mailing list >> http://lists.freebsd.org/mailman/listinfo/freebsd-questions To >> unsubscribe, send any mail to >> "freebsd-questions-unsubscribe@freebsd.org" >> > Wiki's in general are a great idea, I agree. However, you must still consider that anyone can add to a wiki, and the content within could become very cumbersome to maintain. It would (still) require the FreeBSD development team considerable time to verify what is in it and make sure that it isn't going to throw people off. For official documentation, I would have to say that a wiki is not the best idea (unless it is exclusively maintained by the FreeBSD team). Don't get me wrong, wiki's are really cool, but if you want to get down to the facts in official documentation, you can't allow it to get out of hand. My 2 cents...any thoughts? :-) - -Trevor -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (MingW32) iD8DBQFCeN/CoGycRpOgdeERAu0yAJ9nPTcBrW5unJyr4ljWd03t/+a2UgCdHnp0 7tT7lRLsLqHJnmMCZBtLOjU= =BdIK -----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4278DFC2.5060109>