Starters/GitLab-Guide.md

 QUICK GitLab-GUIDE (Registration and first steps) Last update 051117
 
-GitLab is a tool that help us to manage tasks in projects and areas. We can generate a structure (kanban methodology) through labels and thus have an overview of the process, according to the type of tasks and the phase in which they are. Efforts can be estimated and validated which triggers a value compensation for the people who have been working on a task. GitLab and Fairlogin are provided by the FairCoop partner Fairkom.
+GitLab is a tool that help us to manage tasks in projects and areas. We
+can generate a structure
+([kanban](https://www.youtube.com/watch?v=5izyN66PTxs) methodology)
+through labels and thus have an overview of the process, according to
+the type of tasks and the phase in which they are. Efforts can be
+estimated and validated which triggers a value compensation for the
+people who have been working on a task. GitLab and Fairlogin are
+provided by the FairCoop partner Fairkom.
 
 I FIRST PART: registration with fairlogin (NEW USERS)
 
-1. Go to https://git.fairkom.net/users/sign_in
+**1. Go to**
+[**https://git.fairkom.net/users/sign\_in**](https://git.fairkom.net/users/sign_in)
+
+2\. Go to white button fairlogin
+
+You’ll see this screen:
+
+a\) If you’re **already registered** just complete your email and
+password
+
+**b) If not...** go to «New User? Register»
+
+¡! In FAIRLOGIN **you have many languages availables:**
+
+Complete all the information: first and last name, email, password, and
+click on the blue button Register (bottom right side).
+
+¡! **also you’ll need to confirm that «you are not a robot»**
+
+and follow some captcha process until you get **this green tick:**
+
+Then you’ll get an EMAIL VERIFICATION message
+
+Check your email and click on the link you’ll receive.
+
+Once you do it, you’ll be correctly registered so... go again to
+fairlogin <https://git.fairkom.net/users/sign_in>
+
+writte your user and your pass, and you’ll be IN, here in the GitLab
+projects! ;)
+
+*OPTIONS you will see:*
+
+**Create a group for several dependent projects:** Groups are the best
+way to manage projects and members.
+
+**Create a project:** You don't have access to any projects right now.
+You can create up to**10** projects.
+
+**Explore public projects:** There are 10 public projects on this
+server. Public projects are an easy way to allow everyone to have
+read-only access.
+
+For example, if you click on faircoop/MediaCommunication... you’ll see
+this
+
+FOR JOINNING ANY GROUP YOU HAVE TO REQUEST IT
+
+click on white button: **Request Access**
+
+II SECOND PART: using GitLab (first steps)
+
+Explaining menus and options...
+
+**note:** some screenshots of this guide are in Spanish
+
+but normally this will depend on the language chosen by the user.
+
+Click on **Projects,** you can see which ones you are joinning:
+
+At the lateral menu you will find several options as:
+
+**Overview** (inside you’ll find *Activity,* very useful in order to see
+new members, comments, etc)
+
+Issues, Wiki, etc
+
+Overview &gt;&gt; Activity
+
+Issues you can see the «issues» (tickets, tasks) by list or by board;
+also edit the Labels
+
+by list (a list with all the tasks that are in this group with some
+labels assigned)
+
+by board (here we have
+[the](https://www.youtube.com/watch?v=5izyN66PTxs)[kanban](https://www.youtube.com/watch?v=5izyN66PTxs)[board](https://www.youtube.com/watch?v=5izyN66PTxs)
+that shows you all the tasks and the status in columns)
+
+**Labels:** here you can edit and create new labels...
+
+In **Labels,** you can see all the labels already created and *you can
+subscribe yourself to the ones you prefer*
+
+also you can create NEW LABELS clicking on the green button «New Label»
+(but please, if you do it, *make sure it’s gonna be a label all the team
+needs*)
+
+Labels with a (\*) are related with the GENERAL AREAS, so are the most
+important ones:
+
+- Content and revision
+
+- Dinamization chats
+
+- Graphic Design
+
+- PR and Extension
+
+- Social Media Networking
+
+Also are other related with the **status** (columns on the Board):
+
+TO DO (when there’s a task that should be done and it’s waiting for
+someone to take it)
+
+IN PROCESS (when someone takes a task and start working on it)
+
+TO REVIEW (when there’s a task done but need to be revised for more
+people)
+
+TO PUBLISH (when the task is READY and/or already published)
+
+COMPLETED(in order to validate collectively our work, **we need to add 2
+comments \#validated** to every task already published or finished)
+
+OCW VALIDATED (once the task has the 2 \#validated can be added here, in
+the Open Coop Work column; so it will appear in ****
+[**http://kispagi.fair.coop**](http://kispagi.fair.coop/) **** for being
+payed ate the end of the month)
+
+There’s also some labels for languages: ES, CA, EN, FR, IT, EL, PT,
+etc...
+
+- Label URGENT must be used just for urgent tasks have to be done
+
+- Label \*VOLUNTARY should be used for these people who would like to
+make this hour in a voluntary way, *and don’t get them payed in
+Kispagi.*
+
+- Label FREE PROPOSAL is used for you to indicate that it’s a free
+proposal in the area that *still need consensus* in order to know if
+it’s gonna be part of the budget or not.
+
+**Wiki** you can edit and generate new wiki pages (New page)
+
+(on the right side you can see also the repository we have)
+
+II SECOND PART: using GitLab (first steps)
+
+How to add-create correctly an issue (task)
+
+1\. Create the tast
+
+Go to Backlog and click the symbol «+»
+
+Fill the Title (name of the task) and Submit issue (green button)
+
+Once you do it, the issue will appear on the board;
+
+2\. Customize the task: assignee - due date – labels - /estimate
+
+***it’s necessary that you customize** **it** **** **adding** **tags**
+**and other important information***;
+
+Clicking above the task, you’ll see that in the right side (above green
+button Add issues) , you can edit the information related with it:
+
+You have to change for example:
+
+**- Assignee:** assign someone to the task (or yourself)
+
+**¡! In order to validate a task in Kispagi, to add someone is needed
+(always can be changed)**
+
+&gt;&gt; Also, you can assign a task by writing: **/assign @user**
+
+**- Due Date:** deadline
+
+**¡! In order to validate a task in Kispagi, to add a deadline is needed
+(always can be changed)**
+
+**- Time tracking:** you can estimate hours (to do the task) by writing:
+**/estimate \[hours\] h** and **/spend \[hours\] h** (hours than user is
+already spending)
+
+The following time units are available:
+
+weeks (w) | days (d) | hours (h) | minutes (m)
+
+Default conversion rates are 1w = 5d and 1d = 8h. DON’T FORGET to
+Comment ;)
+
+**- Labels:** it’s VERY IMPORTANT that you to add the correct ones so
+the task could be identified and done easily. **&gt;&gt; ¡! In order to
+validate a task in Kispagi, it must be in COMPLETED or OCW VALIDATED
+column (+ 2 \#validated comments).**
+
+&gt;&gt;&gt;
+
+ALSO: when you **click on the Title of the task**, you can see the task
+historical and also edit the task:
+
+when you click on **Edit** (you can edit title of the task and add some
+information about it: for example, it's recommended to add links in the
+task description in order to understand the context better
+
+*(also the pad where you are working, the folder where is the result, or
+the OCP)*
+
+DON’T FORGET to Save changes ;)
+
+then... you also can comment «Nice task! @fulanito» on the task and add
+some emojis:
+
+Everything is registered ;) also you can check here:
+<https://git.fairkom.net/faircoop/MediaCommunication/activity>
+
+On the right corner, next to your profile settings, **you will find some
+alerts**
+
+you can check your **issues** (tasks assigned) by clicking here...
+
+There is a pretty handy Android app to manage GitLab from mobile
+devices:
+
+<https://f-droid.org/packages/com.commit451.gitlab>
+
+or <https://play.google.com/store/apps/details?id=com.commit451.gitlab>
 
 
-2. Go to white button fairlogin