Merge branch '4.4' into 5.0

* 4.4: [Validation] Added a note about validation group names fixing link proofreading reset password refactor caution msg fix typo remove generated code fix title link reset password doc in security draft reset password doc

Author: weaverryan

form/validation_groups.rst

@@ -33,3 +33,10 @@ be used to validate the underlying object. To apply the ``registration``
 group *and* all constraints that are not in a group, use::
 
  'validation_groups' => ['Default', 'registration']
+
+.. note::
+
+ You can choose any name for your validation groups, but Symfony recommends
+ using "lower snake case" names (e.g. ``foo_bar``) in contrast with the
+ automatic validation groups created by Symfony, which use "upper camel case"
+ (e.g. ``Default``, ``SomeClassName``).

security.rst

@@ -1011,6 +1011,7 @@ Authentication (Identifying/Logging in the User)
  :maxdepth: 1
 
  security/form_login_setup
+ security/reset_password
  security/json_login_setup
  security/guard_authentication
  security/password_migration

security/reset_password.rst

@@ -0,0 +1,28 @@
+How to Add a Reset Password Feature
+===================================
+
+Using `MakerBundle`_ & `SymfonyCastsResetPasswordBundle`_ you can create a
+secure out of the box solution to handle forgotten passwords.
+
+First, make sure you have a security ``User`` class. Follow
+the :doc:`Security Guide </security>` if you don't have one already.
+
+Generating the Reset Password Code
+----------------------------------
+
+.. code-block:: terminal
+
+ $ php composer require symfonycasts/reset-password-bundle
+ .....
+ $ php bin/console make:reset-password
+
+The `make:reset-password` command will ask you a few questions about your app and
+generate all the files you need! After, you'll see a success message and a list
+of any other steps you need to do.
+
+You can customize the reset password bundle's behavior by updating the ``reset_password.yaml``
+file. For more information on the configuration, check out the
+`SymfonyCastsResetPasswordBundle`_ guide.
+
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle