closes #1
closes #2 - add documentation