[boost] Re: presentation of libs/smart_ptr/index.htm

From: Eric Friedman (ebf_at_[hidden])
Date: 2003-09-10 20:44:59

David Abrahams wrote:
>
> <irk>
> This has been bugging me for a long time: the title page appears to
> emphasize the exposure of implementation details over the interface.
> When I want to know about weak_ptr and I go to that page, I naturally
> click on the weak_ptr.hpp link, expecting to go to the header's
> documentation.  IMO there's no reason to expose (link to) the details
> of the implementation in the docs at all, but if we really feel it's
> important, it shouldn't be on the front page of the docs.
> </irk>

BoostBook-generated documentation behaves similarly (though the links are
not on the front page). I've long wondered why. Perhaps we should think
about changing it as well?

Eric