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.
