From 06e560e50296ad97e5020fe8decf3f7c5d93072b Mon Sep 17 00:00:00 2001
From: Jon Meow <46229924+jonmeow@users.noreply.github.com>
Date: Tue, 16 Jun 2020 14:49:57 -0700
Subject: [PATCH] Review manager doc (#75)

Mostly to have templates in a central place.
---
 docs/project/review_managers.md | 116 ++++++++++++++++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 docs/project/review_managers.md

diff --git a/docs/project/review_managers.md b/docs/project/review_managers.md
new file mode 100644
index 000000000000..d3598f4d9d2c
--- /dev/null
+++ b/docs/project/review_managers.md
@@ -0,0 +1,116 @@
+# Review managers
+
+<!--
+Part of the Carbon Language project, under the Apache License v2.0 with LLVM
+Exceptions. See /LICENSE for license information.
+SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+-->
+
+## Evolution process duties
+
+As part of [assisting in the evolution process](evolution.md#review-managers),
+review managers are expected to:
+
+- Monitor and respond to topics in
+  [Evolution > Review manager requests](https://forums.carbon-lang.dev/c/evolution/review-manager-requests/15).
+- Announce when RFCs are approaching
+  [readiness for a decision](evolution.md#request-a-review-manager).
+- [Escort the proposal to a decision.](evolution.md#ask-the-reviewing-team-for-a-proposal-decision)
+- [Author and publish proposal decisions.](evolution.md#finalize-the-proposal-decision)
+
+Review managers should additionally provide advice and assistance to proposal
+authors where appropriate, to help ensure the smooth operation of the evolution
+process.
+
+## Templates
+
+### Comment deadline
+
+When an RFC approaches readiness for a decision, the review manager must post a
+1-week comment deadline.
+
+Post the deadline on the topic in
+[Evolution > RFCs](https://forums.carbon-lang.dev/c/evolution/rfcs/6):
+
+```markdown
+COMMENT DEADLINE - YYYY-MM-DD
+
+We’re asking that interested contributors please try to comment on this
+proposal, either in the pull request or this topic, by end-of-day DAYOFWEEK,
+MONTH DD, Pacific Time. We’d like to resolve discussion at that point in order
+to request a decision.
+```
+
+### Decision request
+
+When a proposal moves to decision, the review manager must start the decision
+topic.
+
+Request a decision on a new topic in
+[Evolution > Decisions](https://forums.carbon-lang.dev/c/evolution/decisions/7),
+titled "Request for decision: PROPOSAL":
+
+```markdown
+@core_team: Please provide a decision on "PROPOSAL".
+
+Links:
+
+- [Proposal PR](LINK)
+- [RFC topic](LINK)
+
+Please focus on affirm, object, and stand aside comments in this topic; other
+things specific to reaching consensus may be included. Affirm and object
+comments should include justification for a decision. If you have proposal
+questions, please comment on the proposal itself.
+
+I’ve added this decision as a tentative item for the YYYY-MM-DD core team
+meeting. If consensus is reached before then, the agenda item will be removed.
+```
+
+Link to the decision request on the topic in
+[Evolution > RFCs](https://forums.carbon-lang.dev/c/evolution/rfcs/6):
+
+```markdown
+A decision is now [formally requested](LINK) on this proposal. Community members
+may still comment here, but keep in mind the proposal should not change while
+the reviewing team is considering it.
+```
+
+### Decision announcement
+
+When a proposal has a decision made, the review manager must publish and
+announce the decision.
+
+Decisions should use the [decision template](/proposals/template-decision.md).
+Review managers should create a pull request for accepted proposals;
+declined/deferred proposals should have the same template used as a comment on
+the proposal, with no separate pull request.
+
+Announce the decision on a new topic in
+[Evolution > Announcemented](https://forums.carbon-lang.dev/c/evolution/announcements/8),
+titled "[DECISION] PROPOSAL":
+
+```markdown
+"PROPOSAL" has been DECISION.
+
+Please read the [formal decision PR](LINK) for details.
+
+- [Proposal PR](LINK)
+- [RFC topic](LINK)
+- [Decision topic](link)
+
+This decision is now entering the
+[decision comment period](https://carbon-lang.dev/docs/project/evolution.html#community-comments-on-proposal-decision),
+and, assuming no substantive issues, will be finalized on YYYY-MM-DD. Please
+keep in mind that objections may be posted here.
+```
+
+Link to the decision announcement on **both** topics in
+[Evolution > RFCs](https://forums.carbon-lang.dev/c/evolution/rfcs/6) and
+[Evolution > Decisions](https://forums.carbon-lang.dev/c/evolution/decisions/7):
+
+```markdown
+This proposal has been DECISION, and the [decision announced](LINK). Please keep
+in mind, objections may still be posted to the decision topic as part of the
+decision’s comment period.
+```