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