Updated documentation

Slightly edited the apiary doc, and updated our own local files to match. Also updated the README with some useful info.