While the documentation is very nice overall there are certain areas of detail I feel are a bit too open or challenging to interpret. For example there is a section on Mod Auth Mellon yet a concrete foo.bar outline of settings seems missing. Further more on Identity Broker Documentation its not terribly clear what the outside IDP, in my case SAML will see from the incoming connection, ie you need a client definition as well as a broker. In the export or meta view it looks like the Client and Post back urls are specific to the broker but I believe they are partially or fully combing from the client session instead. It would be nice if sections such as these two as well as say OpenID were a bit more fully documented in a sort of foo.bar fashion. In other words end to end using say some fellow open source applications like the ones in the test suite?
If I've missed some pages I'd be happy to just find some better links