On Fri, 20 Sep 2013, Rainer Gerhards wrote:
On Fri, Sep 20, 2013 at 1:34 PM, David Lang <[email protected]> wrote:
On Fri, 20 Sep 2013, Rainer Gerhards wrote:
On Fri, Sep 20, 2013 at 12:33 PM, David Lang <[email protected]> wrote:
hmm, I tried to login to respond, and after putting in the
username/password in the web form, I then got a browser popup asking for
the site username/password, so something seems odd there.
I think it's worth clearly splitting v5 and earlier from the latest. Many
pages are split this way (referring to the legacy format), but it's not
always clear that that is required for 5.x and optional for the current
version. Occasionally I run into a page (although this may be google
finding the documentation experiment) that gives the new format, but not
the old.
I fear that when we put up the old version docs as well, this "google
problem" will likely happen even more often - and I would even bet that
from then on google will tend to serve the old style (as of Murphy's law
;)).
true, a single page with better clarification of the fact that the new
stuff doesn't work on 5.x and earlier is probably far better.
but then this needs to be linked to from each other page, or am I missing
something?
sorry, I meant a single page on each topic, the way you have it now.
I think some of the confusion is due to the fact that you have to scroll
down a ways before you see any indication of the old stuff, and someone who
just upgraded to the latest version of their distro isn't thinking in terms
of it being 'legacy' :-)
if there's a way to automate it, having a note that for distros ....
require legacy format at the top of the pages could help (right now it's
just about every distro, but at some point it will change from RHEL to RHEL
up to vX so you need a way to change that list in one place and have every
page updated)
mhhh... I don't want to move the legacy stuff towards the top of the page,
as the casual googler usually picks the first he finds. That would mean
we'll never get rid of the complex legacy constructs. But I could add a
sentence a la
"If you use an outdated (pre-v6) version of rsyslog, please scroll down to
the legacy format section, as the enhanced format does not work for those
old versions."
to the top of each page. Do you think that would help (would sufficient
people even notice it while scanning the page)?
exactly what I was thinking, even better if you can have it mention the major
distros that include the outdated version.
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.
