docs updated, Closes #37