On Fri, Dec 13, 2013 at 6:24 PM, Boylan, James <[email protected]>wrote:
> 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. > > yeah, it's a different story. Looks fine, we can transfer at any time you like. @Otis: got the PR, but now family becomes demanding, will take probably till tomorow to merge. Rainer > -- 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. > _______________________________________________ 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.
