On Wed, Nov 26, 2008 at 7:43 AM, Rainer Gerhards
<[EMAIL PROTECTED]> wrote:
> Hi all,
>
> some times it seems to help ask around ;) Andre who cares for the web
> sites (also the phpLogCon lead devel) has pointed out to me that we may
> try the CMS' comment function. We have now enabled that. It seems to
> solve the immediate need. So this looks like a way we can at least try
> out.
>
> Anyhow, if you have any additional thoughts please let me know them.
> They probably help shape a medium-term doc strategy.
>
> Thanks,
> Rainer


I agree with most contributors so far, that a typical user-contributed
wiki alone is not sufficient. For a perfect example of a great project
crippled by abysmal wiki documentation, see OpenNMS.

Wikis /can/ work as official documentation, provided that they are
carefully thought through and official sources are the main
contributors. A general structure also needs to be in place so that
things don't spread out into a web of maze-like links with multiple
pages describing the same subject, albeit with small and crucial
differences. Their main benefits are, obviously, some measure of
self-correction and allowing users to share their solutions to
problems the developers may not have encountered.


Don't know if that helps, but I hope so.

-HKS
_______________________________________________
rsyslog mailing list
http://lists.adiscon.net/mailman/listinfo/rsyslog
http://www.rsyslog.com

Reply via email to