Sabes que la documentación de un proyecto está algo mal, cuando la mejor manera de enterarte como van las cosas es mirando código ajeno o examinando directamente el código fuente original. En mi caso: he aprendido más sobre Bullet mirándome el código fuente de Blender (que utiliza Bullet como motor de física) que la documentación oficial, tutoriales incluidos.

No me quejo, sin embargo. Considero que saber leer código fuente es una habilidad esencial para todo buen programador, y el software libre nos proporciona una enorme biblioteca de donde leer de todo.