updating docs - also closes #23