[Bf-committers] Doxygen docs?

[Alexander Ewering]

On Wed, 5 Jan 2005, zippy wrote:

>>> Hi, I'd be interesting in writing code comments for parts of Blender's 
>>> source code.  I have a fairly good understanding of it, and whoever was 
>>> previously doing this seems to have given up.  I've gotten Doxygen to 
>>> work, and I've found the main doxygen configuration/source files in doc/.
>> 
>> For me (and probably for any other serious developer), the code is pretty
>> much self-explanatory... better spend the time on coding ;)
>
> It is that kind of talk that lead the first developer to drop the project. 
> Any form of better documentation would be helpful. I would like to try out 
> stuff someday again, and it would e nice for dumb noncoders like me.

In my opinion, a project like Blender, as one of the (if not THE one) most
complex open-source projects in existance, is far beyond what a non-coder can
expect to handle.

It's a bit like allowing anyone to drive a car if there's a sheet on the
steering wheel telling them where the brake, accelerator, and coupling is
(or however that is called in English).

| alexander ewering              instinctive mediaworks
| ae[@]instinctive[.]de   http://www[.]instinctive[.]de