Incorporating some feedback about the docs