updated docs, added snippets, closes #21