updated docs, closes #22