yuidoc setup, first generation of docs

- added yuidoc.json config file
- added doc-building instructions in README
- fixed a few docstrings
- generated docs

Assumed we want the docs to be committed; if not, I can remove that commit and send a new PR.