Use autogenerated function documentation

[plata]

The function documentation should be automatically generated from the comments in javascript.

How this could be done with Jenkins: http://blog.cgdecker.com/2011/02/deploying-documentation-to-github-pages.html

And for Travis: https://gist.github.com/vidavidorra/548ffbcdae99d752da02 or https://docs.travis-ci.com/user/deployment/pages/

[plata]

We could also use sphinx-js and ReadTheDocs. There's a description in the example.

What do you think?

[plata]

If we use GitHub pages instead of the wiki for documentation, we should generate the jsdoc to a subfolder (e.g. docs/jsdoc) and then include this as a link or with Jekyll include.

[madoar]

Yes, I agree

[plata]

To generate, execute:

jsdoc -d docs/jsdoc -r .