more updates to the docs