DOC-249: Revised and updated apt readme

Revised and updated apt readme: post-merge-conflict edition. 

Please look over carefully to make sure no information has been dropped.