Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
instead do what? - this looks identical to a single package case of 

```
Do use `RUN apt-get update && apt-get install -y package-bar package-foo
+package-baz`
```
and so I'm failing to grok what you're warning me about.