Re: [Boost-users] Documentation links home

From: Jeff Garland (jeff_at_[hidden])
Date: 2005-09-24 10:55:35

On Sat, 24 Sep 2005 12:40:23 +0100, Andy Little wrote
> Hi,
> 
> I was looking at http://www.boost.org/libs/smart_ptr/smart_ptr.htm 
> and I was surprised to find that there was no link to the main boost 
> page. There are many other doc pages that dont have a link either to 
> their own index pages or the boost index page. (Though many others 
> do e.g http://www.boost.org/doc/html/date_time.html .) 

I think you'll find that all the libraries that use boost-book (as date-time
does) have links to the home as well as a common look and feel.  Libraries
with hand-coded docs are all over the map.  

> Anyone 
> arriving at  pages with no link to their parents has no direct way 
> to find  e.g what is boost or how/ where to download the boost 
> libraries. That aside it is annoying when browsing that one has no 
> means to get back up the tree.  URLs such as smart pointer above are 
> frequently posted on eg comp.lang.++, but the lack of any simple 
> means to get up the tree must leave many potential users stranded 
> and frustrated. Shouldnt it  possible at least to get from any page 
> in a libraries documentation to its main index page (e.g 
> http://www.boost.org/libs/smart_ptr/shared_ptr.htm) and ideally  
> http://www.boost.org/ too?  (FWIW You could at least make the boost 
> logo a link to http://www.boost.org/)

Yes, this would be ideal, but it is alot of work to get all the docs into a
consistent form that everyone can agree.  Even if we get agreement to move
toward a common standard (which I believe we should do) there will be a
tremendous amount of work to get all of boost converted over...

Jeff