Docs for Official Repo release

Changes and additions for the Official Repo release on Wednesday.
ew.  

The `EXPOSE` instruction indicates on which ports a container may listen for connections. 

and _then_ talk about the 3 ways they are used - otherwise the slightly knowledgeable reader thinks 'you're wrong' and needs to force themselves to read to the end to find out its also used for linking.