RETIRED, Gerrit as used by OpenStack
Go to file
Logan Hanks ea3e3b704a Downgrade default notify for WIP reviews
Sometimes reviews are posted to a change while it's in the WIP state.
The owner may be preparing guidance for their upcoming reviewers, or a
CI bot may be reporting about tests. In general, for the purpose of
filtering messages, we distinguish between bot and human actions on the
basis of whether a tag is provided. A non-null tag is assumed to
indicate automation.

For reviews posted by humans, the default notify level depends on
whether hasReviewStarted is true for the change. If a new WIP change is
created and pending reviewers are added, those reviewers should never
receive an email about the change until the owner starts review.
Therefore, when WIP is true, hasReviewStarted is false, and tag is
null, the default notify level is downgraded from ALL to OWNER. If the
change has started review, the default notify level continues to be ALL
(only if tag is null).

For reviews posted by bots, the default notify level is downgraded for
all WIP changes, even after they've entered review. For example, a CI
bot may post failing test results for a series of intermediate patch
sets. This is just noise to reviewers, but useful to the owner, so when
WIP is true and tag is non-null, the default notify level is downgraded
to OWNER.

Change-Id: I93395e36470090377d2120bb8136e7c11670d224
2017-06-14 14:17:25 -07:00
.settings Clean up Gerrit project settings 2017-04-27 10:19:09 +00:00
contrib abandon_stale.py: Adapt to removal of digest authentication 2017-04-21 14:51:59 +00:00
Documentation Downgrade default notify for WIP reviews 2017-06-14 14:17:25 -07:00
gerrit-acceptance-framework Improve performance of notification sender tests 2017-06-14 14:13:30 -07:00
gerrit-acceptance-tests Downgrade default notify for WIP reviews 2017-06-14 14:17:25 -07:00
gerrit-antlr Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-cache-h2 Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-common Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-elasticsearch Add hasReviewStarted, pendingReviewers to Change 2017-06-14 14:13:29 -07:00
gerrit-extension-api Downgrade notify for WIP reviewer deletion 2017-06-14 14:13:30 -07:00
gerrit-gpg Let ExternalIdsUpdate take care to evict accounts from the account cache 2017-06-09 09:56:23 +02:00
gerrit-gwtdebug Format all Java files with google-java-format 2017-02-07 10:04:39 +09:00
gerrit-gwtexpui Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-gwtui Merge branch 'stable-2.14' 2017-06-14 14:56:09 +01:00
gerrit-gwtui-common Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-httpd Convert VisibleRefFilter to assisted factory 2017-06-14 09:51:27 +00:00
gerrit-launcher Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-lucene Add hasReviewStarted, pendingReviewers to Change 2017-06-14 14:13:29 -07:00
gerrit-main Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-oauth Merge branch 'stable-2.14' 2017-04-25 07:23:03 +02:00
gerrit-openid Remove more finals from method signatures 2017-06-14 09:39:19 +02:00
gerrit-patch-commonsnet Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-patch-jgit Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-pgm Avoid referencing gerrit specific Executor. 2017-06-14 14:24:21 +02:00
gerrit-plugin-api Set version to 2.14.1 2017-06-08 12:19:03 +00:00
gerrit-plugin-gwtui Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-prettify Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-reviewdb Add hasReviewStarted, pendingReviewers to Change 2017-06-14 14:13:29 -07:00
gerrit-server Downgrade default notify for WIP reviews 2017-06-14 14:17:25 -07:00
gerrit-sshd Avoid referencing gerrit specific Executor. 2017-06-14 14:24:21 +02:00
gerrit-test-util Mark hunks which are present due to a rebase when diffing patch sets 2017-06-09 13:38:43 +02:00
gerrit-util-cli Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-util-http Format all Java files with google-java-format 2017-02-07 10:04:39 +09:00
gerrit-util-ssl Remove 'final' from method signatures across gerrit. 2017-06-14 09:18:42 +02:00
gerrit-war Merge branch 'stable-2.14' 2017-06-14 14:56:09 +01:00
lib Partial revert of I3cf5f9c823d74da58a8b1326153a672959fa3f13 2017-06-14 11:12:48 -07:00
plugins Convert VisibleRefFilter to assisted factory 2017-06-14 09:51:27 +00:00
polygerrit-ui Merge "Partial revert of I3cf5f9c823d74da58a8b1326153a672959fa3f13" 2017-06-14 20:16:39 +00:00
ReleaseNotes Remove Buck based build 2017-01-23 12:44:58 +00:00
tools Merge branch 'stable-2.14' 2017-06-12 08:54:44 +09:00
website/releases Fix Diffy logo on release page by encoding the image 2015-12-29 10:36:39 -08:00
.bazelproject Build IntelliJ project with full debug info 2017-04-14 11:29:51 -04:00
.editorconfig Added continuation indent to editorconfig 2016-04-26 14:42:58 +02:00
.git-blame-ignore-revs Update git hyper-blame configuration 2017-02-17 16:35:50 +09:00
.gitignore Fix launching daemon in Eclipse on MacOS 2017-03-17 14:10:41 +09:00
.gitmodules Remove the cookbook-plugin submodule 2017-03-24 10:59:31 +09:00
.mailmap Update the .mailmap file 2017-05-03 13:57:18 +02:00
.pydevproject Update PyDev project to use Python 2.7 2014-10-02 15:16:44 +09:00
BUILD Format BUILD and WORKSPACE files with buildifier 2017-02-28 17:32:44 +09:00
COPYING Initial project setup of Gerrit 2 2008-11-14 16:59:34 -08:00
INSTALL Remove Gerrit 1.x to 2.x import tools 2009-03-27 20:20:10 -07:00
README.md Switch GitHub mirror URL to the most up-to-date 2017-04-05 09:03:59 +01:00
SUBMITTING_PATCHES Update push URL in SUBMITTING_PATCHES 2012-03-29 00:57:14 -04:00
version.bzl Set version to 2.14.1 2017-06-08 12:19:03 +00:00
WORKSPACE Partial revert of I3cf5f9c823d74da58a8b1326153a672959fa3f13 2017-06-14 11:12:48 -07:00

Gerrit Code Review

Gerrit is a code review and project management tool for Git based projects.

Build Status

Objective

Gerrit makes reviews easier by showing changes in a side-by-side display, and allowing inline comments to be added by any reviewer.

Gerrit simplifies Git based project maintainership by permitting any authorized user to submit changes to the master Git repository, rather than requiring all approved changes to be merged in by hand by the project maintainer.

Documentation

For information about how to install and use Gerrit, refer to the documentation.

Source

Our canonical Git repository is located on googlesource.com. There is a mirror of the repository on Github.

Reporting bugs

Please report bugs on the issue tracker.

Contribute

Gerrit is the work of hundreds of contributors. We appreciate your help!

Please read the contribution guidelines.

Note that we do not accept Pull Requests via the Github mirror.

Getting in contact

The IRC channel on freenode is #gerrit. An archive is available at: echelog.com.

The Developer Mailing list is repo-discuss on Google Groups.

License

Gerrit is provided under the Apache License 2.0.

Build

Install Bazel and run the following:

    git clone --recursive https://gerrit.googlesource.com/gerrit
    cd gerrit && bazel build release

Install binary packages (Deb/Rpm)

The instruction how to configure GerritForge/BinTray repositories is here

On Debian/Ubuntu run:

    apt-get update & apt-get install gerrit=<version>-<release>

NOTE: release is a counter that starts with 1 and indicates the number of packages that have been released with the same version of the software.

On CentOS/RedHat run:

    yum clean all && yum install gerrit-<version>[-<release>]

On Fedora run:

    dnf clean all && dnf install gerrit-<version>[-<release>]

Use pre-built Gerrit images on Docker

Docker images of Gerrit are available on DockerHub

To run a CentOS 7 based Gerrit image:

    docker run -p 8080:8080 gerritforge/gerrit-centos7[:version]

To run a Ubuntu 15.04 based Gerrit image:

    docker run -p 8080:8080 gerritforge/gerrit-ubuntu15.04[:version]

NOTE: release is optional. Last released package of the version is installed if the release number is omitted.