Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
this sentence pains me - I guess I think it can be written using simpler language.