DOC Document deprecation of old password encryptors (#348)

en/04_Changelogs/5.2.0.md

@@ -0,0 +1,36 @@
+---
+title: 5.2.0 (unreleased)
+---
+
+# 5.2.0 (unreleased)
+
+## Overview
+
+- [Features and enhancements](#features-and-enhancements)
+  - [Other new features](#other-new-features)
+- [API changes](#api-changes)
+- [Bug fixes](#bug-fixes)
+
+## Features and enhancements
+
+### Other new features
+
+## API changes
+
+### silverstripe/framework
+
+The following legacy subclasses of [`PasswordEncryptor`](api:SilverStripe\Security\PasswordEncryptor) have been deprecated, and will be removed in a future major release. If you are using one of these password encryptors in your projects, we strongly recommend swapping to one that has not been deprecated ([`PasswordEncryptor_Blowfish`](api:SilverStripe\Security\PasswordEncryptor_Blowfish) is the current recommendation, and is the default encryptor for passwords in new installations). Note that changing the password encryptor will also require that all of your members reset their passwords.
+
+- [`PasswordEncryptor_None`](api:SilverStripe\Security\PasswordEncryptor_None)
+- [`PasswordEncryptor_LegacyPHPHash`](api:SilverStripe\Security\PasswordEncryptor_LegacyPHPHash)
+- [`PasswordEncryptor_MySQLOldPassword`](api:SilverStripe\Security\PasswordEncryptor_MySQLOldPassword)
+- [`PasswordEncryptor_MySQLPassword`](api:SilverStripe\Security\PasswordEncryptor_MySQLPassword)
+
+## Bug fixes
+
+This release includes a number of bug fixes to improve a broad range of areas. Check the change logs for full details of these fixes split by module. Thank you to the community members that helped contribute these fixes as part of the release!
+
+<!--- Changes below this line will be automatically regenerated -->
+
+<!--- Changes above this line will be automatically regenerated -->
+