Difference between revisions of "How to use Gerrit review tool"

From ETSI Forge
Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
= Links to documentation =
+
== Upload content with the web interface ==
 +
<big>
 +
 
 +
The example is taken from the [[NFV Specfest Wiki]].
 +
Proceed withe the points below:
 +
 
 +
# <span class="ext">Navigate to the project page where you want to upload your contribution, e.g. [https://forge.etsi.org/gerrit/#/admin/projects/nfv-specfest nfv-specfest]</span>
 +
#* If required, click on the <code>Sign in</code> link on the top right and the page to log in with your EOL or Forge credentials.
 +
# Click <code>Create Change</code> 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 <code>Create</code>
 +
#* [[File:Gerrit-online-change-guide.png|700px|thumb|center|How to create a new Change in the Gerrit web UI]]
 +
# Click <code>Edit</code> in the File list at the bottom of the page
 +
#* [[File:Gerrit-online-change-add-new-file1.png|700px|thumb|center|Click edit at the bottom]]
 +
# Click <code>Add</code> to insert a new modification in a file
 +
#* Type a file path (folder and filename, e.g. "upload/jon_snow.yaml") and click <code>Open</code> button.
 +
#* [[File:Gerrit-online-change-add-new-file2.png|700px|thumb|center|Click Add and insert filename]]
 +
# Copy the content you want to submit and paste the content in the newly created file.
 +
# Click <code>Save</code> and then click <code>Close</code>
 +
#* [[File:Gerrit-online-edit-guide.png|700px|thumb|center|Editing a file in the gerrit web UI]]
 +
# Click the blue <code>Publish edit</code> button and then the <code>Publish</code> button on the top right of the page.
 +
#* [[File:Gerrit-online-change-add-new-file2.png|700px|thumb|center|Click Add and insert filename]]
 +
 
 +
</big>
 +
 
 +
== Enable notifications from specific projects or branches ==
 +
 
 +
Notification from changes in projects are configured via the [https://forge.etsi.org/gerrit/#/settings/projects Watched projects] page, available in the Settings.
 +
 
 +
Find more information at Gerrit on [https://gerrit-review.googlesource.com/Documentation/intro-user.html#watch Watched projects documentation]. An extract:
 +
<pre>
 +
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.
 +
</pre>
 +
 
 +
== Upload content using git ==
 +
 
 +
See [https://forge.etsi.org/wiki/index.php/How_to_contribute#Push_your_contribution_to_Gerrit Contribute via git]
 +
 
 +
== Links to documentation ==
  
 
* [https://www.slideshare.net/dluksza/introduction-to-gerrit Introduction to Gerrit]
 
* [https://www.slideshare.net/dluksza/introduction-to-gerrit Introduction to Gerrit]

Latest revision as of 08:53, 25 October 2017

Upload content with the web interface

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

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

See Contribute via git

Links to documentation