[Bf-committers] blender developer documentation

Howard Trickey howard.trickey at gmail.com
Wed Jul 17 14:33:07 CEST 2019


I was wondering: with the Epic grant, which Ton says, in part, will help
onboarding new developers: if the development fund gets to be big enough to
allow it, what about hiring a full-time technical writer to make really
great developer documentation?

I think a possible dream project would be a book like LInux Kernel
Development
<https://www.amazon.com/Linux-Kernel-Development-Robert-Love/dp/0672329468/ref=as_li_ss_tl?ie=UTF8&tag=roblov-20>,
giving a readable and comprehensive description of the architecture, data
structures, development practices, etc.  Of course the downside to that
would be that such a book will almost immediately start to be inaccurate.
So part of the dream would be to keep it constantly updated. But even if
that didn't happen, I think there are large swaths of design and data
structures that will likely stay current for a number of years.

Failing that, just doing a rewrite of all of the documentation that was in
the old wiki would be very useful.


More information about the Bf-committers mailing list