refresh ALM API doc

- restructure doc for improved readability
- updated commands
- added coverage for PnP CSOM

Author: andrewconnell