Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
perhaps bullet points will be more obvious as items for a reviewer of their work to tick off?