Difference between revisions of "Get started"

From ETSI Forge
Jump to: navigation, search
Line 4: Line 4:
  
 
In this page we will go through the initial setup to contribute to the Forge.
 
In this page we will go through the initial setup to contribute to the Forge.
</big>
+
</big>{{My template}}This is the content of the template
  
 
In case something is missing, feel free to edit and add it to this page. If help is needed you can send an email at [mailto:cti_support@etsi.org cti_support@etsi.org].
 
In case something is missing, feel free to edit and add it to this page. If help is needed you can send an email at [mailto:cti_support@etsi.org cti_support@etsi.org].
Line 25: Line 25:
 
Both SSH and HTTPS are supported, the latter is recommend for starters and its usage will be explained below.
 
Both SSH and HTTPS are supported, the latter is recommend for starters and its usage will be explained below.
 
<big>
 
<big>
# Navigate to Gerrit at [https://forge.etsi.org/gerrit https://forge.etsi.org/gerrit].
+
# Navigate to Gerrit at https://forge.etsi.org/gerrit.
 
# Sign in (link in the top right corner) entering your EOL or FORGE credentials.
 
# Sign in (link in the top right corner) entering your EOL or FORGE credentials.
 
#* [[File:Gerrit tutorial signin.png|700px|frameless|Click to enlarge|center|Click to enlarge]]
 
#* [[File:Gerrit tutorial signin.png|700px|frameless|Click to enlarge|center|Click to enlarge]]
Line 35: Line 35:
 
# Click on <code>Generate password</code> button.
 
# Click on <code>Generate password</code> button.
  
<br/>
+
<br />
 
Now Gerrit has a secure password for your HTTP access.  
 
Now Gerrit has a secure password for your HTTP access.  
 
<div style="text-align:center; color:red; font-size:16pt">When cloning a repository you will be asked to insert username and password:
 
<div style="text-align:center; color:red; font-size:16pt">When cloning a repository you will be asked to insert username and password:
 
'''use the password copied from the Gerrit settings, not your EOL password'''.  
 
'''use the password copied from the Gerrit settings, not your EOL password'''.  
 +
 
Don't worry, you will need to insert that only once.</div>
 
Don't worry, you will need to insert that only once.</div>
 
</big>
 
</big>

Revision as of 10:55, 11 April 2018

ETSI Forge collaboration process is based on the Git versioning system. This means that the shared materials and documents are tracked and versioned at each revision.

In this page we will go through the initial setup to contribute to the Forge. LOL!This is the content of the template

In case something is missing, feel free to edit and add it to this page. If help is needed you can send an email at cti_support@etsi.org.

Set up Git

On Windows

Install a Git client on your Windows operating system. You may find a list of Windows applications to manage Git repositories here.

The following steps are based on Tortoise Git, but should be similar for other client.

  1. Install Git for Windows
  2. Install Tortoise Git

Set up your Gerrit profile

In order to use Gerrit to contribute and review code you will need to add your credentials. Both SSH and HTTPS are supported, the latter is recommend for starters and its usage will be explained below.

  1. Navigate to Gerrit at https://forge.etsi.org/gerrit.
  2. Sign in (link in the top right corner) entering your EOL or FORGE credentials.
    • Click to enlarge
  3. Your user name will appear on the top right of the page. Click on it, the select Settings.
Click to enlarge
  1. In the menu on the left, select HTTP Password.
    • Click to enlarge
  2. Click on Generate password button.


Now Gerrit has a secure password for your HTTP access.

When cloning a repository you will be asked to insert username and password:

use the password copied from the Gerrit settings, not your EOL password.

Don't worry, you will need to insert that only once.

How to contribute

Find out how to clone a repository in How to contribute.