Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/gitlab-org/gitaly.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Okstad <pokstad@gitlab.com>2020-06-18 20:15:09 +0300
committerPaul Okstad <pokstad@gitlab.com>2020-06-18 20:15:09 +0300
commit56daa260cf0ff3ecedbf207524111b58e53fa124 (patch)
tree721a443d9339f7a7676f8559140b451e4531c86c /.gitlab
parent7c4e11c528db4889e34af7ad50c02bf86578178d (diff)
Gitaly RFC guide
Introduces a process for introducing RFCs. Closes https://gitlab.com/gitlab-org/gitaly/-/issues/2835
Diffstat (limited to '.gitlab')
-rw-r--r--.gitlab/merge_request_templates/RFC.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/.gitlab/merge_request_templates/RFC.md b/.gitlab/merge_request_templates/RFC.md
new file mode 100644
index 000000000..7f0281690
--- /dev/null
+++ b/.gitlab/merge_request_templates/RFC.md
@@ -0,0 +1,41 @@
+/title RFC: <REPLACE TITLE>
+/label ~"Gitaly RFC" ~backstage
+
+**Accepting comments until <YYYY-MM-DD> UTC**
+
+## Contributor checklist
+
+Check all items before moving onto the next section.
+
+### Pre-Review
+
+- [ ] Verify you have reviewed and understand the [RFC guidelines](doc/rfcs/README.md).
+- [ ] Replace all placeholders in the RFC template:
+ - [ ] Replace `<REPLACE TITLE>` with the RFC title
+ - [ ] Replace `<REPLACE ABSTRACT>` with a short summary of the RFC contents.
+- [ ] Replace all placeholders in this MR template:
+ - [ ] Replace `<REPLACE TITLE>` at the top of the MR description
+ - [ ] Replace `<YYYY-MM-DD>` with the UTC deadline for accepting comments.
+- [ ] Follow the [contributor guidelines for reviews](https://gitlab.com/gitlab-org/gitaly/-/blob/master/REVIEWING.md#tips-for-the-contributor)
+
+### Ready for review
+
+- [ ] Require a minimum of 2 maintainer approvals. Increase if warranted.
+- [ ] Once ready for review, announce the RFC to the Gitaly team (`/cc @gl-gitaly`)
+ - [ ] Announce a time window for accepting comments (at least a week).
+
+### Post-Approval
+
+Once the minimum number of maintainers have approved:
+
+- [ ] Wait until the declared time window expires before taking action to give others a chance to comment.
+- [ ] Once the time window expires, decide to either merge the RFC as is, or address new feedback.
+- [ ] If you choose to make changes, ping the existing approvers so that they may review the changes.
+- [ ] Merge when ready. If you do not have write access to the repository, ping a Gitaly maintainer `@gl-gitaly`.
+
+## Reviewer instructions
+
+1. Familiarize yourself with the [RFC Guidelines](doc/rfcs/README.md)
+1. Identify other reviewers who can offer constructive feedback. Offer them the opportunity to review.
+1. For your review, follow the [Gitaly reviewing guide](https://gitlab.com/gitlab-org/gitaly/-/blob/master/REVIEWING.md).
+1. Approve, but do not merge. Let the contributor merge when ready.