Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
sadly, using `code` quotes looks terrible in headings.