Skip to content

Commit 36d3f3d

Browse files
Revise document based on Simon's feedback
1 parent cf2884a commit 36d3f3d

File tree

1 file changed

+15
-11
lines changed

1 file changed

+15
-11
lines changed

proposals/PROPOSALS.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -56,16 +56,18 @@ Disputes will be resolved by the ED.
5656

5757
The TWG, as an advisory committee to the Haskell Foundation and to the community at large, exists primarily to aid in making good decisions.
5858

59-
All proposals should address the following concerns:
59+
Proposals should explicitly state which **category** they are in (RFC, Community Project, HF Project), or describe why they do not fit into them but should be considered by the committee anyway.
60+
Additionally, all proposals should address the following concerns:
6061
* **Problem statement:** What problem is the proposed work intended to solve? What are the requirements against which a solution should be evaluated? How will solving this problem benefit the community?
6162
* **Prior art:** What other similar work has been done in the community, and how is the proposal related to it?
6263
* **Related efforts:** What other related activities are planned or ongoing? How is the proposal connected to them?
6364
* **Technical and organizational work**: What work is actually being proposed? What technology should be developed, and how will it be managed and cared for going forward?
65+
* **People:** Who will do the work?
6466
* **Success:** What does it mean for the project to have succeeded?
6567
* **Stakeholders:** Who will be affected, and how?
6668
* **Time:** How long will the proposal take to implement?
6769

68-
Additionally, projects seeking HF support or execution should additionally address:
70+
Projects seeking HF support or execution (i.e. Community Projects and HF Projects) should additionally address:
6971
* **Budget:** How much time and money will the project cost initially? What about ongoing maintenance?
7072
* **Additional partners:** Who else will participate in the project?
7173

@@ -75,8 +77,8 @@ One way to address these concerns is to begin with one of the [proposal template
7577
### Pre-Proposal
7678
Prior to submitting a detailed proposal, please post to the Haskell Discourse instance with a summary of the proposal's contents and a subject line that begins with "Pre-HFTP:".
7779
This helps address the prior art and related efforts concerns, and can save time needed to rewrite a proposal in light of previously-unknown opportunities for collaboration.
78-
While submitters are strongly encouraged to discuss their proposal on Discourse ahead of time, proposals will not be summarily rejected for not having done so.
79-
It is sufficient to post a link to the final discussion thread and invite comments and discussion.
80+
While submitters are strongly encouraged to discuss their proposal on Discourse before writing them, proposals will not be summarily rejected for not having done so.
81+
It is sufficient to post a link to an existing draft of the proposal to solicit prior art and related work before revising and formally submitting the proposal.
8082

8183
### Proposal
8284
Having gathered initial feedback, the next step is to write and submit a proposal.
@@ -110,13 +112,15 @@ From time to time, the committee will summarize the current state of knowledge i
110112

111113
The final step of a proposal is for the committee to give a recommendation.
112114
While the committee should take community discussion into account, they are expected to make recommendations based on their own knowledge, rather than simply reflecting the voices of the participants in the discussion.
113-
Fundamentally, there are three potential recommendations: rejection, revision, and acceptance.
114-
*Rejection* means that the committee does not believe that the proposal would, in the balance, bring value to the community, and that it should not be acted upon.
115-
Furthermore, rejection implies that the committee sees no route to making the proposal acceptable that is short of rewriting it from scratch.
116-
Among reasons for rejection may be that the problem itself is not considered significant, that the proposal has costs, harms, or overheads that outweigh the benefits, or that the proposal is simply unworkable or based on incorrect understanding and assumptions.
117-
*Acceptance* means that the committee believes that the proposal should be acted upon as-written.
118-
*Revision* means that the committee believes that the proposal as written should not be accepted, but that with some changes it could be accepted.
119-
This may be technical details, project governance issues, or clarity.
115+
Fundamentally, there are three potential recommendations: rejection, revision, and acceptance:
116+
117+
* *Rejection* means that the committee does not believe that the proposal would, in the balance, bring value to the community, and that it should not be acted upon.
118+
Furthermore, rejection implies that the committee sees no route to making the proposal acceptable that is short of rewriting it from scratch.
119+
Among reasons for rejection may be that the problem itself is not considered significant, that the proposal has costs, harms, or overheads that outweigh the benefits, or that the proposal is simply unworkable or based on incorrect understanding and assumptions.
120+
* *Acceptance* means that the committee believes that the proposal should be acted upon as-written.
121+
* *Revision* means that the committee believes that the proposal as written should not be accepted, but that with some changes it could be accepted.
122+
This may be technical details, project governance issues, or clarity.
123+
120124
At most five revisions will be recommended.
121125
After five revisions, the committee may only recommend acceptance or rejection.
122126

0 commit comments

Comments
 (0)