Improve documentation

[mastrolinux]

Would be very helpful to improve the documentation a bit and provide at least one example of doing a POST request to sign in a user on a SAML login server.

[mattbaird]

PR's accepted!

I won't have time for a while, busy at my new job. If I get time I'll try and write something.