Lack of API docs

[tschellenbach]

emberjs uses this:
http://yui.github.io/yuidoc/

[matthisk]

Investigated a bit, jsdoc seems the most convenient to work with. This is what the code looks like with the doc comments: https://github.com/GetStream/stream-js/blob/documentation/src/lib/client.js. You can generate the docs if you check out that branch and run npm install -g jsdoc and jsdoc src/**/*.js

[tschellenbach]

Nice, looks pretty good. We'll pick up the improvements to the stream-js client in the next mailing. Great work.

[matthisk]

Committed end result on documentation branch: final generated result. It would be cool if we could use something like wicked to use the github wiki as a documentation page, but this tool looks like it is not receiving support, and has an old jsdoc dep (resulting in errors and incorrect behavior).

[matthisk]

#59