Merge branch 'saml-troubleshooting' into 'master'

Add Troubleshooting section to SAML doc.

In response to #1898. We'll properly fix it in another MR.

See merge request !917