better wording
links to documents
minor fixes