On Tuesday 08 July 2014 09:42:37 Edward Diener wrote:
On 7/8/2014 9:04 AM, Andrey Semashev wrote:
Personally, I think distributing pre-built docs as a separate package is a better option. Building docs locally require toolchain that is not distributed or built with Boost, so offering users to build the docs themselves is not quite practical. At the same time, I'm sure most users won't use bre-built docs and just go online, so packaging docs with the sources seems like a waste.
I believe most users will execute the index.html in the top-level directory and expect to be able to view the documentation for any Boost library in which they are interested from the Libraries link there. To think that we will distribute versions of Boost without this is foolish IMO.
Do you actually use pre-built docs? I don't. Neither do most of my coworkers. I don't see why cutting down the archive I need to download by more than a half is foolish.