Re: OSS Project Documentation

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


---------------------------------------------------
PLUG-discuss mailing list - PLUG-discuss@lists.plug.phoenix.az.us
To subscribe, unsubscribe, or to change you mail settings:
http://lists.PLUG.phoenix.az.us/mailman/listinfo/plug-discuss