At 03:10 PM 7/18/2003, Peter Dimov wrote:

>index.html should stay so that www.boost.org/libs/utility works. Whether
>the contents should change is another matter.

Yes, exactly.

In response to requests from Nico Josuttis and others, we committed to every library having an index.htm (or .html) file at its top level. If the actual docs live elsewhere it can just redirect to the correct page.

Doing this allows authors to publish books referring to Boost libraries without being concerned that the location of the library's docs may change within the library's sub-tree.

For the same reason, it is the preferred way for source code to refer to documentation. For example (from <boost/any.hpp>):

// See http://www.boost.org/libs/any for Documentation.

Some of the Boost tools software takes advantage of that convention to determine what library a header file belongs to.

--Beman

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

Reply via email to