Add docs for mcrypt/openssl migration and how to do it.

Note for later, this line needs to be rewritten to not use `Security` for hashing passwords