copy edit for docs

Copy edit for Docs section, added some links to the source.