touch up docs, fix typo in comment