In light of all the negative feedback with inlining documentation with code, I think that it would be appropriate to make a new web section on the wiki for the purpose of documenting how Blender's code works, the design architecture, etc. joeedh