Hi everybody. A reply (from Ido) to one of my previous posts (see link after Python code) suggested that the best place to report errors in the Python API online documentation may be perhaps under 'Foundation and Websites'. During my experiments with the API I found quite a lot of mistakes in the documentation, especially regarding data types; the last one involves the 'co' field of class ShapeKeyPoint. The Python shell says:
| Code: |
>>> type(bpy.data.objects['Cube'].data.
shape_keys.key_blocks[1].data[0])
<class 'bpy.types.ShapeKeyPoint'>
>>> type(bpy.data.objects['Cube'].data
.shape_keys.key_blocks[1].data[0].co)
<class 'Vector'>
|
While http://tiny.cc/utmimw says that it is a 3 elements array. This is the same kind of error reported in my post http://www.blender.org/forum/viewtopic.php?t=24053&highlight= and CoDEmanX provided a good explanation of why this probably keeps happening.
Correcting these errors aparently would involve modifying by hand the output of an automatic documentation generator, which is quite difficult to mantain. I don't know how this thing can be solved but probably Blender users should start by having some sort of central repository for documentation errors.
What if the online API documentation provided a link in every page pointing to some sort of simple wiki-like-discussion-page? What do you think?