tweak docs, closes #41