minor #19774 [Twig] Expand the explanation about the humanize filter (javiereguiluz)

javiereguiluz · javiereguiluz · commit 702fe9cf0db1 · 2024-04-12T10:26:47.000+02:00
This PR was squashed before being merged into the 5.4 branch. Discussion ---------- [Twig] Expand the explanation about the humanize filter Fixes #19758. Commits ------- 7516215 [Twig] Expand the explanation about the humanize filter
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
@@ -391,9 +391,18 @@ humanize
 ``text``
     **type**: ``string``
 
-Makes a technical name human readable (i.e. replaces underscores by spaces
-or transforms camelCase text like ``helloWorld`` to ``hello world``
-and then capitalizes the string).
+Transforms the given string into a human readable string (by replacing underscores
+with spaces, capitalizing the string, etc.) It's useful e.g. when displaying
+the names of PHP properties/variables to end users:
+
+.. code-block:: twig
+
+    {{ 'dateOfBirth'|humanize }}    {# renders: Date of birth #}
+    {{ 'DateOfBirth'|humanize }}    {# renders: Date of birth #}
+    {{ 'date-of-birth'|humanize }}  {# renders: Date-of-birth #}
+    {{ 'date_of_birth'|humanize }}  {# renders: Date of birth #}
+    {{ 'date of birth'|humanize }}  {# renders: Date of birth #}
+    {{ 'Date Of Birth'|humanize }}  {# renders: Date of birth #}
 
 .. _reference-twig-filter-trans:
 
