incomplete compatibility notes in wrong section about rsyslog-doc HOT 7 CLOSED

Thinking about this a bit more "Compatibility" seems to more about compatibility to other syslog implementations, namely the old, venerable sysklogd.

The v_compatiblity.html pages are more like an upgrade checklist when doing upgrades from older *rsyslog_ versions. Maybe a dedicated section titles something like "Upgrades" would be a better fit.

from rsyslog-doc.

I think this is pretty important.
Could those compat notes please be hooked up in the new documentation?

from rsyslog-doc.

You mean the old sysklogd stuff should be moved to the vXcompatibility notrs section?

from rsyslog-doc.

If you look at the current http://www.rsyslog.com/doc/master/#sponsors-and-community web page, it has "If you are upgrading from rsyslog v2 or stock sysklogd, be sure to read the rsyslog v3 compatibility notes, and if you are upgrading from v3, read the rsyslog v4 compatibility notes and if you upgrade from v4, read the rsyslog v5 compatibility notes."

That information does not belong there, but someplace else, e.g. under http://www.rsyslog.com/doc/master/#compatibility or a new section.

Also, the list is incomplete for v8. it misses v6, v7 and v8 compat notes.

For better readability, I'd also suggest to use an itemized list then a single sentence.

from rsyslog-doc.

That's a left-over, will remove it. The compatibility docs live here: http://www.rsyslog.com/doc/master/compatibility/index.html

from rsyslog-doc.

The whole "compatibilty" section on that main page was also junk. The import seems to have merged wildly... Have removed that as well.

from rsyslog-doc.

Ok, the http://www.rsyslog.com/doc/master/compatibility/index.html page looks certainly a lot better structured.

The only complaint/remark I'd have is that it's a bit hard to spot/find in the TOC or start page and it's a bit oddly named.
It's listed under Reference : Compatibility

I would be looking for such a document under "what to consider when updating the software".
E.g. owncloud uses
http://doc.owncloud.org/server/6.0/admin_manual/maintenance/update.html
I think a structure like this would be more intuitive

from rsyslog-doc.