Re: env vars, documentation (Was: [jamboost] environment variables)

From: brock_peabody (bpyama_at_[hidden])
Date: 2003-10-17 13:26:49

--- In jamboost_at_[hidden], "Pedro Ferreira" 
<pedro.ferreira_at_m...> wrote:
[...]

> IMHO a complete, thorough reference would be a waste of time or, 
at least, a
> misuse of time.

I agree, especially since it's stil changing. A complete 
enumeration of features would be good though.

> I think that a tool like bjam would be well served with:
> 
> - For users:
> - a tutorial that covers major use-cases. The one that exists 
is good,
> it just needs a bit more material;
> - a FAQ. I'm sure Volodya's notes would be a good start point;
> - a thorough set of examples/test cases that can serve as 
templates.

That sounds good.

> 
> - For developers:
> - a reasonable amount/quality of comments in the code. I think 
it isn't
> too bad as it is but could certainly be enhanced;
> - a good set of architecture documents.
> 
> Another important point is the responsiveness of people in the 
list, which
> IMO has been excellent, namely thanks to Volodya.

Absolutely. I feel bad about bugging him all the time, that's why I 
brought this up :)

Brock