-
Notifications
You must be signed in to change notification settings - Fork 268
Open
Description
Description:
While reviewing Policy Zero, I identified some areas for improvement and potential updates. Here's a summary:
Missing "Why" Section
- Problem: Policy Zero does not currently include a "Why" section addressing the question:
"Why has this policy been introduced?"
- Suggestion: Add a justification section to Policy Zero to align with the requirement for policies to include their rationale.
Section Title Update
- Current:
# Submitting a Policy Proposal - Proposed:
# Introducing a Policy Proposal - Reason: This update would make the title more consistent with the intended action and terminology.
Policy File Name Conventions
- Current:
Policy file names MUST follow [File name conventions for ADRs](https://github.com/joelparkerhenderson/architecture-decision-record?tab=readme-ov-file#file-name-conventions-for-adrs), e.g.
submitting-policy.md. - Proposed:
Policy file names MUST follow [File name conventions for ADRs](https://github.com/joelparkerhenderson/architecture-decision-record?tab=readme-ov-file#file-name-conventions-for-adrs), e.g.
introduce-policy.md. - Reason: Update the example file name to match the ADR specification and align with the suggested section title change.
Reactions are currently unavailable