Documentation cleanup consisting mostly of re-ordering sections and links to make the docs more readable for new developers. Some small clarifications. (338347)

Documentation cleanup consisting mostly of re-ordering sections and links to make the docs more readable for new developers. Some small clarifications. (338347) · Gerrit Code Review