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.
