Re: Best Practices question

Paul Lussier <pll@lanminds.com> writes:
> Is this how it is currently maintained? The reason I ask, is FAQs
> often suffer from lack of updating, and I've found in the past that
> tools like FAQ-O-Matic help reduce FAQ-rot :)

I've only had experience with a couple of FAQ-O-Matic-ized FAQ
documents, so maybe I'm speaking from ignorance, but as far as I can
tell, It Does Not Work.

FAQs are for humans, and need humans to maintain them. Software can
assist with this, of course, but FAQ-O-Matic doesn't really address
the problem of assisting a human maintainer(s). Instead, it tries to
automate and decentralize maintenance. The results are some pretty
awful FAQs, filled with redundant, out-of-date, and inconsistent
information (that's three separate sins, yes, and I've seen them all).

Is FAQ-O-Matic really easier than mailing a patch?

> What is the procedure for submitting a patch? Do I just mail it to
> the dev list? Of course, this should be a FAQ itself, shouldn't it :)

Just send to dev@subversion.tigris.org. And the first one can be a
patch about how to add new FAQ items, yes :-).

Thanks,
-Karl

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Oct 9 23:39:55 2002