Tweak

Author: javiereguiluz

reference/constraints/Choice.rst

@@ -395,7 +395,9 @@ Parameter        Description
 
 **type**: ``string`` **default**: ``-------------------``
 
-This option allows you to customize separator after preferred choices.
+This option allows you to customize the visual separator shown after the preferred
+choices. You can use HTML elements like ``<hr>`` to display a more modern separator,
+but you'll also need to set the `separator_html`_ option to ``true``.
 
 .. versionadded:: 7.1
 
@@ -406,7 +408,9 @@ This option allows you to customize separator after preferred choices.
 
 **type**: ``boolean`` **default**: ``false``
 
-If this option is true, `separator`_ option will be display as HTML instead of text
+If this option is true, the `separator`_ option will be displayed as HTML instead
+of text. This is useful when using HTML elements (e.g. ``<hr>``) as a more modern
+visual separator.
 
 .. versionadded:: 7.1