Updated the docs to have more consistent phrasing and better links