Re: [boost] [Boost-docs] [1.35] Where to place PDF versions of docs?

From: Joel de Guzman (joel_at_[hidden])
Date: 2007-11-02 20:27:27

Jeff Garland wrote:
> John Maddock wrote:
> 
>> Also building the HTML documentation as a single "book" from doc/ simply 
>> isn't viable anymore IMO: it doesn't scale well (takes an age to build, 
>> breaks at the drop of a hat etc).  It worked when we only had a few 
>> Boostbook libraries, but we have too many for this now. 
> 
> I think this is an important point -- PDFs have to be *by library*.  Full 
> date-time user/reference docs are 400 pages so all of boost would be 
> thousands.  Up to now, I've been generating date-time PDFs and putting them on 
> my site which obviously isn't the ideal system. Personally I don't think we're 
> ready to solve this issue in time for 1.35 so I think we should take it as an 
> independent effort.

FWIW, I agree. I'd even venture to suggest that we have one
URL for placing all our generated docs (html/pdf). Then, we can
simply redirect to it from our library doc's index.html. That
would mean though that people who download a snapshot needs to
have net access to get the docs.

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net