some updates to the docs