Documentation update

[Cantor, Scott]

> Thus far I have made significant inroads into Attribute Definitions.  I need
> to do a refresh over the ScriptedAttribute definition and also write up the
> Transient and CryptoTransient definitions which I'll only do once I
> completely understand the use case (which is SAML1 only, right?)

No, the transient defiitions are purely deprecated compatibility and even there it's questionable because they're completely duplicated by the new stuff. Transients never go inside Attributes, so there's no functionality gap. You're thinking of Persistents, and the SAML 1 case of sticking them into an Attribute with the old NameID attribute encoder thing.

So I'd probably say, point to V2 and note they're unneeded now.
 
> One particular issue is the "spring native" syntax for the three data
> connectors: Do we want to provide examples of this?

If we can, like anything it's just a matter of priority.

-- Scott