docs: name_order states its valid values and comma-input scope

Verified: assign consults name_order only for the NO_COMMA structure;
'Yamamoto, Haruki' takes family from the comma format with name_order
never read.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: derek73

docs/customize.rst

@@ -65,6 +65,8 @@ listed below.
      - Assigns positional (no-comma) input to given/middle/family in
        this order. Use the exported ``GIVEN_FIRST`` (default),
        ``FAMILY_FIRST``, or ``FAMILY_FIRST_GIVEN_LAST`` constants.
+       Ignored for comma-format input ("Yamamoto, Haruki"), which
+       states its own order.
    * - ``patronymic_rules``
      - ``frozenset[PatronymicRule]``
      - Reorders patronymic-shaped names via opt-in detectors — East

nameparser/_policy.py

@@ -64,9 +64,13 @@ class Policy:
     only what you change -- ``Policy(maiden_delimiters={("(", ")")})``
     -- and pass the result to ``Parser(policy=...)``."""
 
-    #: How positional (no-comma) input maps onto given/middle/family;
-    #: one of the exported GIVEN_FIRST (default), FAMILY_FIRST,
-    #: FAMILY_FIRST_GIVEN_LAST orders.
+    #: How positional (no-comma) input maps onto given/middle/family.
+    #: Valid values are exactly the three exported constants --
+    #: GIVEN_FIRST (the default), FAMILY_FIRST, and
+    #: FAMILY_FIRST_GIVEN_LAST; any other tuple of Roles raises
+    #: ValueError. Ignored when the input contains a comma:
+    #: comma-format input ("Yamamoto, Haruki") states its own order
+    #: explicitly.
     name_order: tuple[Role, Role, Role] = GIVEN_FIRST
     #: Opt-in detectors that reorder patronymic-shaped names
     #: (EAST_SLAVIC, TURKIC); usually set via a locale pack.