Difference between revisions of "Get started"

From ETSI Forge
Jump to: navigation, search
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
Windows
+
<big>
 +
ETSI Forge collaboration process is based on the [https://git-scm.com/ Git] versioning system.
 +
This means that the shared materials and documents are tracked and versioned at each revision.
  
Install a Git client on your Windows operating system. (We recommend [Tortoise Git|https://tortoisegit.org/], the following steps are based on that client, but should be similar
+
In this page we will go through the initial setup to contribute to the Forge.
 +
</big>
  
How to clone a repository
+
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].
  
Go to Gerrit
+
= Set up Git =
Sign in (if not done already)
 
Go to Projects -> List and select the reposotiry you want to contribute to and copy the repository.
 
  
Select Clone and "http".
+
== On Windows ==
  
Oper the destination folder, right click and select Clone Git Repository.
+
Install a Git client on your Windows operating system.
 +
You may find a list of Windows applications to manage Git repositories [https://git-scm.com/download/gui/windows here].
 +
 
 +
The following steps are based on [https://tortoisegit.org/ Tortoise Git], but should be similar for other client.
 +
 
 +
# Install [https://git-for-windows.github.io/ Git for Windows]
 +
# Install [https://tortoisegit.org/ Tortoise Git]
 +
 
 +
= Set up your profile =
 +
 
 +
In order to use the git repositories at Forge, to contribute and to review code you will need to
 +
# <big>'''Log into''' the platform: [https://forge.etsi.org/gitlab/users/sign_in Click here]</big>
 +
## Use your <u>'''EOL credentials'''</u> to login.[[File:Login.png|center|frameless|552x552px]]
 +
# <big>(Optional) Set up your '''SSH keys''': [https://forge.etsi.org/gitlab/profile/keys Click here]</big>
 +
## This is needed if you intend to push/pull commits over SSH. [[File:Ssh.png|center|frameless|605x605px]]
 +
# <big>(Optional) '''Customize''' your profile: [https://forge.etsi.org/gitlab/profile Click here]</big>
 +
## You may add your picture, some bios, etc. [[File:Profile.png|center|frameless|600x600px]]
 +
# <big>'''That's it'''! Now visit the [https://forge.etsi.org/gitlab/explore/projects Projects] or [https://forge.etsi.org/gitlab/explore/groups Groups] pages to discover the many activities on the Forge.</big>
 +
 
 +
= How to contribute =
 +
 
 +
Find out how to clone a repository in [[How to contribute]].

Latest revision as of 17:03, 26 October 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.

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 profile

In order to use the git repositories at Forge, to contribute and to review code you will need to

  1. Log into the platform: Click here
    1. Use your EOL credentials to login.
      Login.png
  2. (Optional) Set up your SSH keys: Click here
    1. This is needed if you intend to push/pull commits over SSH.
      Ssh.png
  3. (Optional) Customize your profile: Click here
    1. You may add your picture, some bios, etc.
      Profile.png
  4. That's it! Now visit the Projects or Groups pages to discover the many activities on the Forge.

How to contribute

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