Re: [jamboost] [BBv2] Building BJam wiki documentation update

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-07-05 10:35:49

Rene Rivera wrote:
> Andrey Melnikov wrote:
> 
>>Found http://www.boost.org/tools/build/jam_src/index.html#building_bjam 
>>from Jam doc which can help me a lot.I wonder why we have the same 
>>documentation in multiple places :(
> 
> Where is the jam_src/index.html information duplicated?
> 

http://www.boost.org/tools/build/jam_src/index.html#building_bjam
http://www.boost.org/tools/build/v1/build_system.htm#installing_jam
http://www.boost.org/more/getting_started.html#step2

I like the idea of having both brief "Howto" documentation and full 
"Reference" documentation. But 3 sets of documentation in 3 different 
places are confusing. Also "Howto" should have the most important and 
frequently used information from "Reference". Now all 3 "refences" are 
incomplete, each page contains information other pages don't. At least 
we should add more structure.

Andrey