Update documentation to (hopefully) address points raised in #97