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 On Wed, 2008-11-26 at 13:28 +0100, Rainer Gerhards wrote: > 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 _______________________________________________ rsyslog mailing list http://lists.adiscon.net/mailman/listinfo/rsyslog http://www.rsyslog.com
