making requested changes to docs