another pass on the docs