Readme update

The purpose of this PR is to document the new functionality added in https://github.com/plataformatec/devise/pull/2728.

However, I couldn't help but notice a few inconsistencies in the README. I fixed each type of inconsistency in a separate commit. I'll rebase this PR after review.