Was the docs good enough to help you on your way or was there stuff missing do you think ?

The docs were a good starting point. I have used them before to make a google login. However, the package that provides the authentication: https://github.com/Sustainsys/Saml2 It doesn't actually use a "remote authentication handler", so Umbraco couldn't automatically do its magic there.