Skip to content

Commit 9ffb36e

Browse files
hasufellAndreasPK
authored andcommitted
Re-word and be explicit about multi-phase proposals
1 parent f87f99e commit 9ffb36e

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

PROPOSALS.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,8 @@ To be more precise, as the proposal author, you will be expected to do the follo
6767
tasks, or find volunteers who'll do this for you. You may post a brief proposal and
6868
request feedback on feasibility before investing time and effort in the full process.
6969

70+
The following is a step by step guide for common proposals:
71+
7072
1. Refine your proposal.
7173
2. Make impact assessment.
7274
3. Write a migration guide.
@@ -115,8 +117,19 @@ request feedback on feasibility before investing time and effort in the full pro
115117
* all changes to `base` package slated for future release should land in GHC `master` before the next major release branch is forked (also see [GHC wiki on major releases](https://gitlab.haskell.org/ghc/ghc/-/wikis/GHC-status#1-major-releases))
116118
- backports are usually reserved for security or packaging matters
117119

118-
Make sure the proposal is merged in a reasonable timeframe. The CLC reserves the right to consider a proposal
119-
as ![abandoned][label:abandoned] if it has not been merged within a year since approval (this nullifies the vote).
120+
If your proposal is a "multi-phase proposal" with multiple implementation and deprecation steps, make sure to
121+
precisely define when each step is supposed to take place.
122+
123+
### A note on stale proposals
124+
125+
The CLC can revoke its approval for a proposal if an **"activity"** has been overdue for over a year. The revocation request, which
126+
explains what has changed with the passage of time to justify the review, can be initiated by the chair. If no CLC member vetos
127+
the request, then it automatically passes.
128+
129+
**"Activity"** is defined as a successfully carried out implementation step, e.g.
130+
131+
- for a simple proposal: whether it has been merged
132+
- for a multi-phase proposal: whether the next step has been carried out as planned
120133

121134
## The "when"
122135

0 commit comments

Comments
 (0)