On Sat, 14 Dec 2013, Pavel Levshin wrote:
13.12.2013 22:19, David Lang:
On Fri, 13 Dec 2013, Pavel Levshin wrote:
Newest version of docs which is published on the site is not very reliable
when you are not brave one using bleeding edge software. You never know if
this doc applies to you setup.
lots of things in the docs talk about what version they were introduced in,
more things need to have version tags added.
Those tags are of no use, if the document is applied to one known version,
only. I personally think that there tags make docs overloaded with
unnecessary historic information. This is like having version control system
and still describing each change in commentaries.
Since rsyslog has really good backwards compatability, almost all these tags end
up being 'introduced in vx.y.z' which is a fairly small impact.
It would be better for users to have several versions of docs on the site,
at least, for major branches as 5-stable, 7-stable, 7-devel and master. It
may increase you traffic, though.
well, the community only supports the latest version, right? ;-)
I don't think so, at least 7-stable, 7-devel and 8-devel are supported now.
And previous version is also good to have, just to show its deficiencies.
I should have said we only support one stable version, you are correct in the
versions supported now, but it's usually just one -stable and one -devel with
the features added in -devel going into a stable before very long.
David Lang
_______________________________________________
rsyslog mailing list
http://lists.adiscon.net/mailman/listinfo/rsyslog
http://www.rsyslog.com/professional-services/
What's up with rsyslog? Follow https://twitter.com/rgerhards
NOTE WELL: This is a PUBLIC mailing list, posts are ARCHIVED by a myriad of
sites beyond our control. PLEASE UNSUBSCRIBE and DO NOT POST if you DON'T LIKE
THAT.
