GitLab-GIE
==========

- Git_ és un `sistema de control de versions`_ dels que s'anomenen `distribuïts`_.

- Gitlab_ és una plataforma de col·laboració per a programadors que utilitza Git, és adir, una `aplicació web`_ que permet crear i compartir projectes Git entre els seus usuaris.

- Avantatges:

  * Evitar treballar amb diferents directoris i carpetes en el nostre ordinador, corresponents a diferents versions del projecte (o programa).

  * Git_ i Gitlab_ són eines que es fan servir a tot el món i tenen llicència lliure (de GNU)

  * Conèixer-los és un know-how valuós.
  
- A l'assignatura disposem del nostre gestor GitLab propi, `gitlab-gie`_.


Com obtenir-hi un compte d'usuari?
----------------------------------

Per tal d'obtenir un compte d'usuari del gestor `gitlab-gie`_ de
l'assignatura cal fer el següent:
  
#. Visiteu la `pàgina de registre
   <https://gitlab-gie.cs.upc.edu/users/sign_up>`_ i ompliu el
   formulari.

   .. image:: pas1.png
      :align: center

   .. warning::
   
      És indispensable que l'adreça de mail sigui d'un domini de la upc.

#. Espereu que l'administrador activi el vostre compte.


Com crear un projecte?
----------------------

#. Un cop tingueu el compte actiu, inicieu una sessió a `gitlab-gie`_.

   .. image:: pas2.png
      :align: center
   
#. Cliqueu el botó :guilabel:`+ New project` i trieu un projecte buit (*blank*). 

#. Ompliu les dades del vostre projecte (nom, descripció, etc)

   - Cal que el situeu dins del grup de projectes del quatrimestre actual de l'assignatura.

   - Cal que el projecte sigui públic.

  .. image:: pas3.png
     :align: center

#. Llegiu les instruccions per a treballar amb el projecte que acabeu de
   crear.

#. Compartiu el projecte amb els altres estudiants que el desenvoluparan, amb el botó :guilabel:`+ Invite members`.

   - Assigneu-los el rol de mantenidor (Mantainer)

   .. image:: pas4.png
     :align: center

   
Com treballar amb GitLab-GIE?
-----------------------------

Usarem el dipòsit `gitlab-gie`_ per compartir els canvis amb
altres usuaris.

A la :ref:`guiagitlab` trobareu com treballar amb GitLab.




.. _Git: https://ca.wikipedia.org/wiki/Git
.. _GitLab: https://ca.wikipedia.org/wiki/GitLab
.. _inicieu una sessió:
.. _gitlab-gie: https://gitlab-gie.cs.upc.edu/
.. _sistema de control de versions: https://en.wikipedia.org/wiki/Revision_control
.. _distribuïts: https://en.wikipedia.org/wiki/Distributed_revision_control
.. _aplicació web: https://ca.wikipedia.org/wiki/Aplicaci%C3%B3_web