In any case, it then makes more sense to fork the rsyslog repo and work on it's doc path.
Sent from phone, thus brief. Am 13.12.2013 22:31 schrieb "Rainer Gerhards" <[email protected]>: > I think for part of it it is inevitable. We could try to keep as much as > possible. For the rest, we can do html pages that just link to the new > ones. Not perfect, but we need to change the structure in any case. .. > > Sent from phone, thus brief. > Am 13.12.2013 22:26 schrieb "David Lang" <[email protected]>: > >> 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. >> > _______________________________________________ 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.
