Currently there is no documents repo. :) I was just going to create a starting on my account to save Rainer time. Transferring it over to the Rsyslog organization later takes no time at all.
-- James -----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of Otis Gospodnetic Sent: Friday, December 13, 2013 11:23 AM To: rsyslog-users Subject: Re: [rsyslog] doc contributions Why not just fork + add/edit + send a PR? I just did that for some minor README mods. Otis -- Performance Monitoring * Log Analytics * Search Analytics Solr & Elasticsearch Support * http://sematext.com/ On Fri, Dec 13, 2013 at 12:20 PM, Boylan, James <[email protected]>wrote: > I've started digging in with the link that Rainer gave me. It is an > good start. I'm going to look into customizing the output to be > something more familiar. That being said, the really nice part is that > once this is done, from what I can tell, the raw .rst files that are > used to generate everything once uploaded into github will be viewable > right there in a nice, clean format that is comparable to the outputted > material. > > Rainer - > > I'm going to create a rsyslog-docs repo in my personal account to > commit to. Once I get something solid to work with, I'll toss a link > for everyone to look at and if everyone likes it we can move it into > the rsyslog organization on github. > > -- James > > -----Original Message----- > From: [email protected] [mailto: > [email protected]] On Behalf Of Otis Gospodnetic > Sent: Friday, December 13, 2013 10:27 AM > To: rsyslog-users > Subject: Re: [rsyslog] doc contributions > > Progress, not perfection. +1. :) > > Fingers crossed that James' research around doc format and conversion > results in something actionable. > > Otis > -- > Performance Monitoring * Log Analytics * Search Analytics Solr & > Elasticsearch Support * http://sematext.com/ > > > On Fri, Dec 13, 2013 at 11:13 AM, Rainer Gerhards > <[email protected]>wrote: > > > On Fri, Dec 13, 2013 at 4:11 PM, Otis Gospodnetic < > > [email protected]> wrote: > > > > > Btw. I'm confused now. Where are the docs going to live? My > > > feeling was Github, so I'm not sure why WP account would be needed. > > > > > > Tactical vs. strategical approach. We have seen that folks have > > problems with the current HTML format. A very simple and instant > > solution is to use the project web directly. We do this already for > > FAQ-type of things, or things that otherwise do make limited sense > > inside the doc set itself. An example for the latter is the dynamic > > repository pointer I posted today -- the whole point is that it is > > NOT inside the tarball, so that we can change it -for all doc > > versions- when there is need to. Another thing is policies that may > > change over > time. > > > > In any case, using WP gets us started today, whereas otherwise we > > need to wait until agreement on new doc system everybody feels > > comfortable with. I love the current momentum, and I fear that now > > waiting for the > "right" > > solution will cause loss of this momentum. In the longer term, all > > of this can be integrated into the new doc that hopefully becomes > > available within the next couple of month. > > > > Does this sound fair enough? > > > > Rainer > > > > > This doesn't feel > > > right... don't you want to have just 1 place for docs that people > > > contribute to? (and then figure out how to transform to other > > > formats to publish elsewhere, if needed). > > > > > > > > Thanks, > > > Otis > > > -- > > > Performance Monitoring * Log Analytics * Search Analytics Solr & > > > Elasticsearch Support * http://sematext.com/ > > > > > > > > > On Fri, Dec 13, 2013 at 3:46 AM, Radu Gheorghe > > > <[email protected] > > > >wrote: > > > > > > > Hi Rainer, > > > > > > > > Yes, thanks, I want :) > > > > > > > > Though I think I'll begin by contributing doc improvements via > > > > GitHub first. I'll also think of an (easy) way to make the > > > > documentation more obvious, more up-to-date. > > > > > > > > In the light of the latest discussions, this is easier said than > > > > done, > > so > > > > for now I think we have quite a lot of ideas and we need to > > > > switch to actually doing them :) > > > > > > > > > > > > 2013/12/13 Rainer Gerhards <[email protected]> > > > > > > > > > Radu, James, all, > > > > > > > > > > if you like, I can create accounts for you on the rsyslog site > > > > > so > > that > > > > you > > > > > can create FAQ and similar content right there. This is a > > > > > pretty > > plain > > > > > Wordpress site, so no need to know HTML or anything else but > > > > > how to > > > use a > > > > > browser ;) > > > > > > > > > > Let me know and we can get this started *today*. > > > > > > > > > > Rainer > > > > > > > _______________________________________________ > > > 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. > _______________________________________________ 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.
