Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
What advice would you give?