Create good docs

[mattpilott]

Currently we generate markdown files from jsdoc but its quite a poor experience (better than nothing though!) with M3 we should make something nicer