Interesting that many of us don't understand some of the functionality of NumericJS. I'm running into the same problem in
http://agentscript.org .. its hard to document.
I settled, for now, on Docco, where comments in the source turn into fairly nice documentation.
The tension is between API documentation, how users interact with the package, and developer documentation. I think the latter is better for libraries like Numeric, it exposes how it works and the rational for the architecture.
Maybe we oughta help out and document the code via Docco?
BTW: when you look at the page, you're seeing Knuth's "Literate Programming" where the document is actually compiled! The more usual documentation is simpler, code comments turned into markdown or html.
-- Owen