docs: reference lists members in source order; strip_bidi self-contained

autodoc's default alphabetical member sort scrambled the deliberate
field ordering (strip_bidi rendered before strip_emoji, orphaning its
'the same way' reference; Lexicon's vocabulary grouping interleaved).
autodoc_member_order = 'bysource' matches the codebase's
declaration-order-is-canonical rule and the customize.rst table; the
strip_bidi doc is also now self-contained regardless of ordering.

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

Author: derek73

docs/conf.py

@@ -36,6 +36,12 @@
     'sphinx.ext.viewcode',
 ]
 
+# Declaration order is canonical in this codebase (Role order drives the
+# seven-field order everywhere), so the reference lists members in
+# source order, not alphabetically -- Lexicon's vocabulary grouping and
+# Policy's field ordering match the customize.rst table.
+autodoc_member_order = 'bysource'
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 

nameparser/_policy.py

@@ -95,8 +95,9 @@ class Policy:
     #: field, or rendered view. The original string keeps them (input
     #: is never modified -- spans stay true).
     strip_emoji: bool = True
-    #: Excludes bidirectional control characters from tokenization the
-    #: same way.
+    #: Excludes bidirectional control characters from tokenization:
+    #: they appear in no token, field, or rendered view; the original
+    #: string keeps them.
     strip_bidi: bool = True  # =False replaces v1's opt-out CONSTANTS.regexes.bidi = False
 
     # in the class body so @dataclass(slots=True) keeps them