[Bf-committers] Blender C-Cookbook

John K. Walton bf-committers@blender.org
Tue, 22 Apr 2003 10:40:13 -0400 (EDT)

On Tue, 22 Apr 2003, Nathan Vegdahl wrote:

>    I'd be willing to write documentation on the areas of the rendering code
> that I'm working on.  Besides, that might help me pay my way to SIGGRAPH. :)
>    Of course, this all depends on how much time I'll have to spare.  Durring
> the summer I'll have plenty of time, but before then most of my time is taken
> up by school.
>    I do like the idea.  It would allow more people to dive into the code more
> quickly.
>    On the down-side, however, the code is constantly changing, so the
> documentation could, potentially, get out-dated quite rapidly.

this is my concern too. a subscription web base distribution makes more
sense with this consideration. that way you always have documentation
as uptodate as the writters can write it. by the time it's written/proof
read/published/distributed and sold, it gets out of date. previous blender
book all had this problem: a limited lifetime.

I had bought books on 'documenting the xxxxxx source code' they were a
waste of money.

>    --Nathan Vegdahl
> --- Ton Roosendaal <ton@blender.org> wrote:
> > Hi all,
> > 
> > Our partner in publishing, NoStarch press in the USA, is interested to  
> > work at several new books on Blender for 2003. Apart from a new  
> > Complete Blender (2.3) manual, they would like to evaluate other  
> > possibilities as well.
> > 
> > One idea would be a book on coding for Blender. This might be a huge  
> > task - since the lack of documentation we're suffering from. However,  
> > it could be written as a sort of recipy book with tutorials on how to  
> > make an importer, add a rendering algorithm, adapt a tool, etc. As a  
> > positive side effect the level of documentation on the code could be  
> > improved significantly with this project.
> > 
> > I cannot make promises yet, but I assume this work will be a paid job,  
> > with the authors getting royalty on the sales.
> > 
> > Please give me some feedback on the idea!
> > 
> > -Ton-
> __________________________________________________
> Do you Yahoo!?
> The New Yahoo! Search - Faster. Easier. Bingo
> http://search.yahoo.com
> _______________________________________________
> Bf-committers mailing list
> Bf-committers@blender.org
> http://www.blender.org/mailman/listinfo/bf-committers