Andrey Semashev-2 wrote
On Monday 21 July 2014 08:16:10 Robert Ramey wrote:
Paul A. Bristow-2 wrote
Keeping auto-generated files in git is not a good idea. Syncing is not as simple as it may seem, it also spams history and increases the repo size. There was a discussion about this earlier, and I think the consensus was unanimous.
lol - maybe it was unanimous among those who see it as an issue. But remember that the incubator is not boost. Each developer can use the method he wants. The only requirement set by the indicator is that there be browsable html documentation. How that is produced and maintained is totally up the library developer/submitter. The incubator only points to the finished product.
IMO, Blincubator should not encourage developers to store auto-generated files in git.
It doesn't currently describe, mention, recommend or encourage any particular method for maintaining the html docs. I just requires that they exist. Had I thought about while writing the advice section, I would have recommended storing the html in git for the reasons I mention above. I thought about doing that now - but it's really beside the point. The incubator doesn't even specify the usage of GitHub, Git or anything else - just that there be a repository. So I'm pleased just to not make any recommendation at all on this subject.
It should offer a way to publish built docs or an easy way to integrate with a third party hosting.
It's even better than that!!! It lets the library submitter publish the documents anyway he want's to!!! All he has to do is to produce html version in some publicly accessible place.
Otherwise it is not a suitable platform for publishing and reviewing libraries.
lol - maybe it's not - we'll find out eventually. Robert Ramey -- View this message in context: http://boost.2283326.n4.nabble.com/Boost-Library-Incubator-Unable-to-submit-... Sent from the Boost - Dev mailing list archive at Nabble.com.