Skip to content

Commit 43b4fc7

Browse files
docs: render decision section numbers
1 parent 7417a54 commit 43b4fc7

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

docs/decisions/0023-extend-static-roles.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Copying the complete role definition would make the deployment responsible for e
1616
Decision
1717
********
1818

19-
#. Role extension fields
19+
1. Role extension fields
2020
========================
2121

2222
A ``role_extensions`` entry identifies an existing static role with ``role`` and changes only the fields included in the entry. It may use:
@@ -46,19 +46,19 @@ For example:
4646
4747
Fields that are not present keep their current value. An extension cannot change the role ID or replace its complete definition.
4848

49-
#. Hiding a role
49+
2. Hiding a role
5050
================
5151

5252
Setting ``hidden: true`` removes the role from the normal API results used to discover roles and create assignments. It does not delete the role, remove existing assignments, or change permission checks. This keeps hiding separate from removing a role, whose assignment checks are defined in `ADR 0018`_.
5353

54-
#. Validation and priority
54+
3. Validation and priority
5555
==========================
5656

5757
The compiler resolves extensions after it loads every static role and permission. It rejects an extension when the target role or one of the permissions does not exist. Adding a permission that the role already has or removing one it does not have produces a warning and leaves the result unchanged.
5858

5959
Several applications or deployment files may extend the same role. Changes to different fields are combined, while priority resolves changes to the same metadata field or permission. If two contributions with the same priority disagree, validation stops before the database changes.
6060

61-
#. Tutor patch
61+
4. Tutor patch
6262
==============
6363

6464
The Tutor integration for ``openedx-authz`` provides a named ``openedx-authz-schema`` patch. A Tutor operator can create a small plugin that uses this patch to contribute the same YAML accepted from application packages.

0 commit comments

Comments
 (0)