2024-12-04 14:32:39 +00:00
# Purpose
2024-12-16 11:58:00 +00:00
Policy Zero establishes the foundational guidelines for creating,
reviewing, and maintaining policies in the `status-go` Git repository.
This policy aims to create a collaborative, inclusive, and transparent
process for defining repository policies, specifically regarding how
developers engage with and contribute to the `status-go` repository.
2024-12-20 16:01:00 +00:00
For a more detailed description, please refer to [the README.md ](./README.md ).
2024-12-04 14:32:39 +00:00
2024-12-10 14:53:30 +00:00
# Submitting a Policy Proposal
2024-12-04 14:32:39 +00:00
- Any individual MAY propose a new policy.
2024-12-16 11:58:00 +00:00
- Policy ideas SHOULD be discussed with contributors who wish to have
a voice in how the repository operates, including Core Contributors
(CCs) and external contributors.
2024-12-12 16:20:05 +00:00
- All policies MUST be submitted to the `_docs/policies`
directory as a pull request (PR) within the `status-go` repository.
- All policies MUST be in Markdown format.
2024-12-16 12:04:19 +00:00
- 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` .
2024-12-20 16:01:00 +00:00
- A policy MUST include a brief justification, addressing the question:
"Why has this policy been introduced?"
2024-12-04 14:32:39 +00:00
# Review and Approval Process
2024-12-16 11:58:00 +00:00
- Policy PRs SHOULD be reviewed by as many contributors as possible
who wish to engage in the process.
- Any CC MAY review, approve, and/or request changes to a policy
proposal PR.
2024-12-10 14:53:30 +00:00
- For any policy PR to be eligible for merging, it:
2024-12-16 11:58:00 +00:00
- MUST address all feedback provided during the review process.
2025-01-20 15:56:16 +00:00
- MUST be approved by all team leads (of Status Desktop, Mobile and Waku Chat).
2024-12-16 11:58:00 +00:00
- MUST be approved by all members of the @status -im/status-go-guild
GitHub team.
2025-01-20 15:56:16 +00:00
- MUST receive a minimum of six approvals, regardless of the number
of team leads or members of the @status -im/status-go-guild GitHub team.
2024-12-04 14:32:39 +00:00
2024-12-16 20:34:16 +00:00
# Policy Overrides
2024-12-17 14:47:39 +00:00
2024-12-16 20:34:16 +00:00
On rare occasions, circumstances may necessitate that an established
2024-12-20 16:01:00 +00:00
policy is intentionally circumvented. This is considered an **override**
and MUST follow the process outlined below to ensure transparency
and collective agreement:
2024-12-16 20:34:16 +00:00
2024-12-20 16:01:00 +00:00
- Any override MUST be documented in a public and permanently
referenceable form (such as a forum post, or GitHub comment or issue),
and MUST include:
2024-12-16 20:34:16 +00:00
- The specific policy being overridden,
- The rationale for taking this action,
2025-01-20 15:56:16 +00:00
- The potential risks and impacts of the **override** , AND
2024-12-16 20:34:16 +00:00
- Steps taken to minimise those risks.
2024-12-20 16:01:00 +00:00
- Before executing the override of any policy, the override:
- MUST be approved in writing by at least one team lead from the
Status Desktop or Status Mobile teams, AND
- MUST be approved in writing by at least one member of the
@status -im/status-go-guild GitHub team.
2024-12-16 20:34:16 +00:00
- Policies MAY define additional rules for handling overrides, provided
2024-12-20 16:01:00 +00:00
the above baseline requirements are also met.
2024-12-16 20:34:16 +00:00
2024-12-10 14:53:30 +00:00
# Policy Amendments and Archival
2024-12-04 14:32:39 +00:00
2024-12-10 14:53:30 +00:00
- Amendments
2024-12-16 11:58:00 +00:00
- Policies MAY be amended at any time.
- Amendments MUST be submitted via a PR to the `status-go` repository.
2024-12-12 16:20:05 +00:00
- Archival
2024-12-16 11:58:00 +00:00
- Policies MAY be archived if they are obsolete or replaced by
newer policies.
- Archival MUST be performed by submitting a PR that moves the
policy to `_docs/policies/archived` .
- The PR MUST include a rationale for the proposed amendment or
archival in the PR description.
2024-12-10 14:53:30 +00:00
- The PR MUST follow the [Review and Approval Process ](#review-and-approval-process ).