Skip to content

Commit 3fd0549

Browse files
committed
docs(contributing): define allowed comments on Goal issues
1 parent cc4df2f commit 3fd0549

1 file changed

Lines changed: 13 additions & 0 deletions

File tree

docs/CONTRIBUTING.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,19 @@ As soon as you get involved, you must:
5757
Each Goal description must include Specs (a Google Document with commenting
5858
permissions) and an ETA.
5959

60+
Comments on a Goal issue are only appropriate for:
61+
62+
- **ETA update** — when the delivery date changes
63+
- **Priority change** — when the Goal is deprioritised or elevated relative
64+
to other Goals (e.g. "pausing this Goal, focusing on X instead")
65+
- **Spec review request** — asking someone to review the Spec document or
66+
address comments left in it
67+
68+
Everything else — questions, blockers, progress updates, PR links — does not
69+
belong in the Goal issue. Blockers go as `Problem:` sub-issues. Questions go
70+
in the Spec document. Progress is implied by the absence of open Problems and
71+
a valid ETA.
72+
6073
> [!NOTE]
6174
> A Goal is represented as a GitHub issue in the relevant repository and has the
6275
> following naming pattern: `Goal: [statement]`.

0 commit comments

Comments
 (0)