-
Notifications
You must be signed in to change notification settings - Fork 1
Closed
Labels
backlogBacklog (not current milestone)Backlog (not current milestone)documentationImprovements or additions to documentationImprovements or additions to documentation
Description
Context
ban-nondeterminism.sh supports a file-based allowlist mechanism (.ban-nondeterminism-allowlist) for exempting specific paths from determinism checks. This is powerful but undocumented in RELEASE_POLICY.md.
Current State
- The script reads
DETERMINISM_ALLOWLISTenv var (defaults to.ban-nondeterminism-allowlist) - Allowlist format: one glob pattern per line,
#comments supported - No governance documentation for when/how to use exemptions
Desired Behavior
Add a section to docs/RELEASE_POLICY.md documenting:
- What the allowlist is and where it lives
- When an exemption is acceptable vs. when code should be refactored
- Approval requirements for adding allowlist entries
- How allowlist entries are audited
Acceptance Criteria
- New section in RELEASE_POLICY.md covering allowlist governance
- Cross-reference from ban-nondeterminism.sh header comments
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
backlogBacklog (not current milestone)Backlog (not current milestone)documentationImprovements or additions to documentationImprovements or additions to documentation