Hi Michael, thanks for the feedback.
On Wed, 2008-11-26 at 13:10 +0100, Michael Biebl wrote: > Imho it would be very unfortunate, if the documentation would only be > available online. > > A wiki can be a very good *additional* source of documentation (for > stuff like best practices, tips and tricks), but it doesn't substitute > a well written manual. > > What I would rather like to see (and I know, I'm repeating myself > here), is to have the existing documentation a bit more structured and > easier accessible. I posted examples like the exim [1] or postgresql > [2] documentation, which I think are excellent. I think the PHP manual is also a good sample. But actually this doesn't solve my main point: It is quite time-consuming to create a good doc. I am ready to put a bit more time into that (moving that away from development), but I would like to encourage user contributions. Without bashing, it is one thing to show a good example, but it is a totally different one to provide good content ;) The bottom line is that I know I could do better, but I have not sufficient time (and probably not the best talent in that area) to actually do it. > The postgresql documentation is interesting. If you follow [2] the > link, you can see, that users are able to add comments, which could be > helpful to improve the overall documentation. This is the main point. Maybe I can find a way to easily make user comments available to the current doc set. That would help drive in user contributions (at least I hope so). The problem again is that I simply can not invest a few weeks of my time "just" to get the right doc display system done. It's a trade-off between time available, hoping to get contributions and quality of doc. Again, I value your thoughts very much, they go in the same direction of what I hope to have, but it looks like I currently can not achieve this and need to lower my demands in order to get working, solution - but one that is better than the current state... Rainer _______________________________________________ rsyslog mailing list http://lists.adiscon.net/mailman/listinfo/rsyslog http://www.rsyslog.com
