On Fri, 13 Dec 2013, Rainer Gerhards wrote:
Some quick notes:
David is right with the versioning - I overlooked that. Not a big deal, i
need to pull into the central repo.
Small html is good.
Breaking urls is not a problem: we can do redirects (own infrastructure
;)). That's ok with google. One day of very boring work at most.
you also break the knowledge of where to look for things in the lcoal docs.
don't depend just on server level redirects.
David Lang
Rainer
Sent from phone, thus brief.
Am 13.12.2013 21:29 schrieb "David Lang" <[email protected]>:
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.
_______________________________________________
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.
_______________________________________________
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.