Restructure of RST docs
Extensions of the api description
SAML doc improvements
Enhanced documentation
Merge branch 'better-docs' into 'develop'

Better docs