IMO, there are two doc requirements: 1. A reference doc, with all the aerogear modules, ie include:
https://www.npmjs.com/package/@aerogear/push https://www.npmjs.com/package/@aerogear/security https://www.npmjs.com/package/@aerogear/app https://www.npmjs.com/package/@aerogear/cordova-plugin-aerogear-metrics
with a one liner outlining the usage 2. introduce the modules as needed in the individual procedures