13.12.2013 22:19, David Lang:
On Fri, 13 Dec 2013, Pavel Levshin wrote:
Maybe I could help with the site, too, but I'm not sure what to do
right now.
One thing I wish see changed at the website is online version of HTML
docs. Having them browseable does not really help when they are
installed on a user's server without GUI and web server on it.
actually, as long as you have a browser (even a text-only browser like
one such as links or lynx) you can open the files locally. That said,
it would be nice to have the distros make a -doc package so that
what's deployed is smaller
besides, if you don't have the html docs, what format are you going to
use? the docs are really too large to be man pages reasonably
(although that would be nice)
You are right in that these docs are not very suitable for console
reading. They are much better viewed in GUI WWW browser. For console
reading, I prefer plaintext.
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.
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 agree that forking the docs per major version would be handy.
--
Pavel Levshin
_______________________________________________
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.
