update readme and docs with api changes
Merge pull request #500 from mrocklin/doc-edits

update readme and docs with api changes