[Validator] Document the alpha3 option of Language

Author: javiereguiluz

reference/constraints/Country.rst

@@ -77,8 +77,6 @@ Basic Usage
 Options
 -------
 
-.. include:: /reference/constraints/_groups-option.rst.inc
-
 alpha3
 ~~~~~~
 
@@ -92,6 +90,8 @@ If this option is ``true``, then the constraint will valid the value as
 `ISO 3166-1 alpha-3`_ three-letter codes (e.g. France = ``FRA``) instead
 of the default `ISO 3166-1 alpha-2`_ two-letter codes (e.g. France = ``FR``).
 
+.. include:: /reference/constraints/_groups-option.rst.inc
+
 ``message``
 ~~~~~~~~~~~
 

reference/constraints/Language.rst

@@ -6,7 +6,8 @@ Validates that a value is a valid language *Unicode language identifier*
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
+Options     - `alpha3`_
+            - `groups`_
             - `message`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Language`
@@ -77,6 +78,19 @@ Basic Usage
 Options
 -------
 
+alpha3
+~~~~~~
+
+.. versionadded:: 5.1
+
+    The ``alpha3`` option was introduced in Symfony 5.1.
+
+**type**: ``boolean`` **default**: ``false``
+
+If this option is ``true``, then the constraint will valid the value as
+`ISO 639-2`_ three-letter codes (e.g. French = ``fra``) instead
+of the default `ISO 639-1`_ two-letter codes (e.g. French = ``fr``).
+
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``message``
@@ -95,3 +109,6 @@ Parameter        Description
 ===============  ==============================================================
 
 .. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+.. _`ISO 639-2`: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes