re-word / fixup docs