Re: [boost] [website] Tools docs usability problem

From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2007-11-24 16:20:04

Hartmut Kaiser wrote:
>  
> Rene Rivera wrote:
> 
>>> When working 
>>> with these tools, you are usually using either the command 
>> line or a GUI 
>>> directory tree browser, not a web browser. Thus it is now a 
>> real pain in 
>>> the anatomy to locate the docs since aren't right there 
>> where you are 
>>> working. Worse yet, you may fail to realize there *are* any 
>> docs, and 
>>> never look for them at all.
>> Hm... Quick survey:
>>
>> tools/bcp/bcp.html
>> tools/boostbook/doc/*.xml (end up in doc/html/boostbook.html)
>> tools/build/index.html (redir to tools/build/v2/index.html)
>> tools/buildbot (no docs yet)
>> tools/common (no docs)
>> tools/inspect/index.html
>> tools/jam/index.html (redir to doc/html/jam.html)
>> tools/litre (no docs)
>> tools/quickbook/index.html (redir to 
>> tools/quickbook/doc/html/index.html)
>> tools/regression/index.html (redir to tools/regression/doc/index.html)
>> tools/release (no docs)
>> tools/wave (no docs)
> 
> The docs for the Wave tool are part of the library docs and the old tools
> overview page used to redirect there.

Ah, yes I forgot to mention the tools/index.html file. Which indeed does 
have the link for Wave go to the corresponding library docs. It also 
have links for the other tools going to the obvious places.

-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo