We should document how password storage can be upgraded using PasswordEncoder.upgradeEncoding and UserDetailsPasswordService.