Jump to content

Gerrit/Navigation

From mediawiki.org

Gerrit's user interface can be difficult to navigate. The following documentation helps find stuff in the web user interface of Gerrit.

Browsing projects

[edit]
  • To view all projects, select Browse > Repositories in the top bar.
    • The core MediaWiki source code is in the project "mediawiki/core".
  • Use "Repository Browser > gitiles" to inspect the code base.
    • If you want to look at the code for the version of MediaWiki or an extension deployed on some wiki, visit that wiki's Special:Version page and look for the corresponding branch or commit. Then select the corresponding branch in the sidebar of gitiles.
  • Select "Changes > View all" to see the latest commits.

Browsing code in a repository

[edit]

After selecting Browse > Repositories in the top bar and selecting a code repository, select "Repository Browser > gitiles" to browse its code base.

Search queries

[edit]

Gerrit offers a search field in the upper right corner. It includes a full-text search on commit messages, authors or reviewers (names and email addresses), etc.

To search for specific values items, use keywords.

Example: List of commits to all MediaWiki repos which have been, or need to be, reviewed by the Gerrit user called "jforrester":

project:^mediawiki/.* reviewer:jforrester AND -owner:L10n-bot

It excludes the L10n-bot which sometimes alters the results.

Example: List of commits authored by anyone in the newcomers group and the commits passed CI (have a positive Verified label) and have either CR-1 or CR-2 (patch needs rework):

ownerin:newcomers status:open label:Verified>=1 label:Code-Review<0

Search queries via SSH

[edit]

You can also run queries from the command line. This requires a developer account. Connect over ssh to execute commands of the form gerrit query ' query parameters ' on the gerrit host. The search operators are the same as in the web interface. See the query command documentation.

Example: List of unreviewed commits under mediawiki:

ssh -p 29418 yourPersonalUsername@gerrit.wikimedia.org gerrit query 'status:open project:^mediawiki/.* AND NOT label:Code-Review<=-1'

For the number of unreviewed patches, see the rowCount value in the output of this command.

Performing code review

[edit]

See Gerrit/Tutorial#How code is reviewed in Gerrit

Reports

[edit]
Report Developer Resources