Update docs around making requests

- includes a live example that shows we need the signon api key, not the tokens that exist inside pp-deployment (are these now completely redundant?)
- Updates example json responses to show off the exciting new user listings
Merge pull request #180 from alphagov/document_users

Update docs around making requests