GerritBot is a tool used for importing GitHub Pull Requests (PRs) into Gerrit for code review. It was created because the Go team does all its reviews in Gerrit, but we'd like to allow a more common workflow for contributing code via GitHub PRs.
You need a Gmail or other Google account to register for Gerrit. This is a limitation of the infrastructure that runs our Gerrit instances and is out of our control, plus you already need a Google account to sign our CLA, a requirement for us to accept your contribution in the first place.
Replies to comments on code in Gerrit are first saved as drafts and need to be published via the “Reply” button. This is to prevent multiple emails per review “session” and is similar to the pending review workflow in GitHub. If you see a number next to the “Reply” text in the button, this means you have pending drafts to publish.
It uses the title and description of the GitHub PR to construct the commit message for the Gerrit change. You can edit this using the GitHub web interface (not Gerrit or git). The PR description is in the first text area in the “Conversation” tab of the GitHub PR. It is editable via “Edit” option on the “...” menu.
Note: Gerrit imports the plain text that is viewable as you edit the message in GitHub, and it does not import the rendered text you see in GitHub prior to editing.
One common area of related confusion is around issue references. For example, GerritBot or a human reviewer might ask you to avoid URLs for issue references. In Gerrit, you might see the full URL for an issue, but in the GitHub web interface, you might only see an issue reference like #12345 and it might be unclear where the URL is coming from. This can be due to confusion between the rendered view in GitHub vs. the underlying raw/plain text. If the GitHub web interface shows something like Fixes https://github.com/golang/go/issues/12345 while you are editing the text in GitHub, change it to something like Fixes #12345 or Fixes golang/go#12345 instead. See the Contribution Guide for more on issue references.
Once the PR is edited in GitHub, it can take 10 minutes or so before the Gerrit change is updated.
CL is short for “change list”, which is essentially a patch proposed to be introduced into a repository. The Go project uses Gerrit to carefully review each CL. An example CL is https://go.dev/cl/508475.
Gerrit change is another term for CL.
Yes, this is highly encouraged, and a great way to familiarize yourself with Gerrit, the Go project's code review process, and the internals of the Go standard library, runtime, compiler, and so on.
You can browse the currently open CLs here and subscribe for updates to interesting CLs by clicking the star icon.
You don't need to be an expert in the code to help with initial review triage. See the section on helping to review CLs in the Gardening wiki page for more details.
You can upload as many commits as you like. GerritBot will handle squashing your commits into one change that Gerrit can handle.
This is due to an open bug with the way Gerrit handles acting as another user. Once that is fixed, the original author will also be the owner of the change.
You can toggle comments from GerritBot by using the comments slash command (e.g., /comments off).
Please file an issue and use the x/build/cmd/gerritbot: prefix in the title.