update docs with a better API section
Merge pull request #15 from mojotech/sjs/update-docs

update docs with a better API section