Skip to content

Commit 3e2da71

Browse files
committed
docs(contributing): order registry-reached helpers by enum or registry
Owner ruling: getattr and registry-map helpers follow the enum value order, or the registry order when there is no enum.
1 parent fc2eb79 commit 3e2da71

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

‎docs/source/contributing/conventions/protocol-member-order.rst‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ The Order
2424
time, in the order ``read()`` or ``make()`` first uses them. "Uses" means a
2525
direct reference in the body of ``read()`` or ``make()``. Helpers reached only
2626
through ``getattr``, or through the registry maps (``__proto__``,
27-
``__option__``, ``__parameter__`` and similar), do not count. Each helper's
27+
``__option__``, ``__parameter__`` and similar), do not count. They are ordered
28+
by the enum value order of the corresponding code, or by the registry's order
29+
where there is no enum. Each helper's
2830
``_read_`` and ``_make_`` methods stay together, with the reader first:
2931
``_read_mac_addr()`` then ``_make_mac_addr()``.
3032
c. **Specific readers and makers.** The option, type and parameter methods,

0 commit comments

Comments
 (0)