docs: list the AmbiguityKind and PatronymicRule members in the reference

Enum members without doc comments are skipped by autodoc, so the
'stable vocabulary of kinds' was invisible on the very page that
promised it. Each member now carries a #: doc -- honestly marking
ORDER and SUFFIX_OR_NICKNAME as reserved (no emitter yet; planned
2.x) and describing the emitter behavior of the three live kinds.
PatronymicRule's two members get the same treatment.

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

Author: derek73

nameparser/_policy.py

@@ -13,9 +13,17 @@
 
 
 class PatronymicRule(StrEnum):
-    """Stable rule names (API); implementations live in the pipeline."""
+    """Stable rule names (API); implementations live in the pipeline.
+    Enable via ``Policy(patronymic_rules={...})`` or, more commonly, a
+    locale pack (:mod:`nameparser.locales`)."""
 
+    #: East Slavic formal order: "Sidorov Ivan Petrovich"
+    #: (family, given, patronymic) is detected by the patronymic
+    #: ending and reordered. Enabled by locales.RU.
     EAST_SLAVIC = "east-slavic"
+    #: Turkic patronymic markers: a standalone "oglu"/"qizi"/"kyzy"
+    #: (etc.) binds to the preceding name as a patronymic. Enabled by
+    #: locales.TR_AZ.
     TURKIC = "turkic"
 
 

nameparser/_types.py

@@ -218,10 +218,23 @@ class AmbiguityKind(StrEnum):
     compares directly. New kinds may be added in minor releases;
     existing values never change meaning."""
 
+    #: Reserved: the name's field order itself is uncertain (e.g. a
+    #: two-word name under a non-default name_order). Not yet emitted;
+    #: planned for 2.x.
     ORDER = "order"
+    #: Reserved: a trailing word reads plausibly as either a suffix or
+    #: a nickname. Not yet emitted; planned for 2.x.
     SUFFIX_OR_NICKNAME = "suffix-or-nickname"
+    #: A leading ambiguous particle was read as a given name -- "Van
+    #: Johnson" parses given="Van", but "Van" is also a family-name
+    #: particle in other names.
     PARTICLE_OR_GIVEN = "particle-or-given"
+    #: A nickname/maiden delimiter opened without closing (or closed
+    #: without opening); the text was kept as literal name content.
+    #: May carry no tokens.
     UNBALANCED_DELIMITER = "unbalanced-delimiter"
+    #: More comma-separated segments than any recognized name shape;
+    #: the parse is best-effort over the extra segments.
     COMMA_STRUCTURE = "comma-structure"