Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
these long inline code blocks do not render well, and become hard to read.