OSS Project Documentation

[Alan Dayley]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Darrin Chandler wrote:
> 
> Sounds like you want a wiki. MediaWiki is popular, but there are several
> others that are also popular and well regarded. Many people use wikis
> for internal company documentation. Alan Dayley was just talking about
> using one at his work.
> 
> I'm sure others here can give you good specific suggestions.

Sure, Darrin, put me on the spot!  ;^)

At work we like and use TWiki (http://twiki.org).  The big features we
like are:
- - Full version control on every page and every attachment using RCS on
the back end.
- - No database on the back end.
- - Full read/write access control if you want to use it.  We almost never
do beyond functional (ie. Engineering vs. Marketing) separation, but it
is there.

Dislikes:
- - The WYSIWYG editor is not as good as some other wikis have.  This is a
BIG barrier to adoption and contribution for anyone not familiar with
the concept of text markup for display control.
- - No database on the back end can make searches slow.

If you or anyone has specific questions about it, I'm happy to answer.

Alan


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (GNU/Linux)
Comment: Using GnuPG with SUSE - http://enigmail.mozdev.org

iD8DBQFGHR/IDQw/VSQuFZYRAuRhAJ4jjyfvPFA9m/SC1frBrQh2cvXWKQCeJ4fn
hmrugZ0kVI+7TklM/21Ip4c=
=PpYb
-----END PGP SIGNATURE-----