some updates to the documentation