Re: [boost] [Boost Library Incubator] Unable to submit library

Subject: Re: [boost] [Boost Library Incubator] Unable to submit library
From: Robert Ramey (ramey_at_[hidden])
Date: 2014-07-21 15:50:06

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-library-tp4665328p4665401.html
Sent from the Boost - Dev mailing list archive at Nabble.com.