improve docs (closes #16)