I agree the repo might not be the best location. I could easily generate a series of .tar.gz for each one. That is certainly an option. Then they could just be posted for download?
-- James -----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of Rainer Gerhards Sent: Monday, December 16, 2013 8:19 AM To: rsyslog-users Subject: Re: [rsyslog] [doc] Generated documentations. On Mon, Dec 16, 2013 at 3:14 PM, Boylan, James <[email protected]>wrote: > So a question I had while working on this documentation. Should I > commit the outputs for this? > > What I'm thinking of is just running the build command for the various > formats and storing them into a build-html, build-man, build-txt set > of directories. It seems to me that would help people who don't have > the time to generate the documents themselves. > > *contributor head on* I usually think that generated files do NOT belong into repositories. However, some folks may have a really bad time generating the doc. So providing readily accessible formats definitely is a plus. I am just not sure if the best place is inside the repository -- or actually a "doc release" the goes alongside the code release (and with maintainer head on, I think we need to coordinate that in any case -- but that's not a hard vote). So I am undecided what's the best way to achive it, but I think generated output should be readily available. 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.
