5.0.3: CLI documentation (rebased onto develop)


This is the same as gh-868 but rebased onto develop.

----

This PR addresses several CLI documentation needs summarized in https://trello.com/c/AmB1db6W/57-5-0-3-documentation-fixes.

                
existing