How to use Gerrit review tool

From ETSI Forge
Jump to navigation Jump to search

Upload content with the web interface[edit | edit source]

The example is taken from the NFV Specfest Wiki. Proceed withe the points below:

  1. Navigate to the project page where you want to upload your contribution, e.g. nfv-specfest
    • If required, click on the Sign in link on the top right and the page to log in with your EOL or Forge credentials.
  2. Click Create Change button
    • Enter Branch, e.g. master
    • Enter Change topic. Topics are used to gather sets of Changes which are about the same feature. E.g. "specfest"
    • Enter the description of the Change.
    • Click on Create
    • How to create a new Change in the Gerrit web UI
  3. Click Edit in the File list at the bottom of the page
    • Click edit at the bottom
  4. Click Add to insert a new modification in a file
    • Type a file path (folder and filename, e.g. "upload/jon_snow.yaml") and click Open button.
    • Click Add and insert filename
  5. Copy the content you want to submit and paste the content in the newly created file.
  6. Click Save and then click Close
    • Editing a file in the gerrit web UI
  7. Click the blue Publish edit button and then the Publish button on the top right of the page.
    • Click Add and insert filename

Enable notifications from specific projects or branches[edit | edit source]

Notification from changes in projects are configured via the Watched projects page, available in the Settings.

Find more information at Gerrit on Watched projects documentation. An extract:

To get to know about new changes you can watch the projects that you are interested in. 
For watched projects Gerrit sends you email notifications when a change is uploaded or 
modified. You can decide on which events you want to be notified and you can filter the 
notifications by using change search expressions. 
For example 'branch:master file:^.*\.txt$' would send you email notifications only for 
changes in the master branch that touch a 'txt' file.

It is common that the members of a project team watch their own projects and 
then pick the changes that are interesting to them for review.

Project owners may also configure notifications on project-level.

Upload content using git[edit | edit source]

See Contribute via git

Links to documentation[edit | edit source]