update docs - closes #2