mrdoob/three.js — pull request #801 by jterrace (2011-11-26 23:13:03+00:00)
Title: Adds Documentation Generation using jsdoc-toolkit and Sphinx

This creates a root directory called doc. It has a Makefile that does the following:
1. Downloads [jsdoc-toolkit](http://code.google.com/p/jsdoc-toolkit/)
2. Clones [jsdoc-for-sphinx](https://github.com/stdbrouw/jsdoc-for-sphinx)
3. Uses jsdoc-toolkit and the sphinx template to output sphinx files for three.js
4. Runs a sphinx build to produce HTML output

This adds documentation directly into the JS source files. Is this acceptable? I think it's the easiest way to maintain documentation since it's collocated with the code itself.

This is an example of the output that gets produced:
http://www.cs.princeton.edu/~jterrace/temp/threejs/generated/core/THREE.Color.html
I have only documented the THREE.Color class so far, so this is just an example page.

To be clear: **this is not ready to merge**. I just wanted to open this up to get comments since I don't want to spend the time documenting the rest of the project if this is not the route the maintainers want to take.