RSA doc update for deprecation. Move some examples.
add information about why we deprecated the concrete providers
simplify examples per dreid's suggestion
Merge pull request #1150 from reaperhulk/rsa-doc-update

RSA Deprecation Doc Update