some updates to docs