Skip to content

GitLab 102 training

See the GitLab 101 training for an introduction to GitLab.

Issue assignments

In GitLab, issues are assigned to a specific person. This ensures that tasks gets done, but it also

Exercise:

  • create an issue and assign it to yourself or a teammate responsible for completing it.
  • note about multiple assignees and too many cooks

Reminder about how issues can be public by default, and private projects.

Staying Up to Date: Notifications and To-Dos

Stay informed without getting overwhelmed.

  • Notifications: Watch projects or specific issues to receive updates when changes happen.
  • To-Do list: Use your GitLab To-Do list to see items awaiting your attention (e.g., mentions or assignments).
  • Adjust your notification settings to control how and when you receive alerts.

Status, Labels, Milestones, and Epics

These tools help organize and track larger bodies of work.

  • Status: the kanban workflow, see below
  • Labels categorize issues by schedule, topic, service, etc
  • Milestones group issues around a deadline or event (e.g., Annual Fundraiser).
  • Epics (if your group uses them) collect related issues across projects, giving a big-picture view of multi-step initiatives.

Dashboards and kanban charts

A more advanced way to organize your issues is to use the Dashboard feature in GitLab. Many teams use this to organise their work. Once you pass a dozen issues, it becomes difficult to have a good view of all the issues managed inside your team or assigned to you, and dashboards help processing those issues step by step.

Try to create a link like this, but replacing anarcat with your user:

https://gitlab.torproject.org/groups/tpo/-/boards/2675?assignee_username=anarcat

This will show you a "waterfall" model of what tasks you're doing "next" or "right now". The different states are:

  • Needs Triage: untriaged issue, move it to one of the states below!
  • Doing: what you're actually working on now
  • Next: will be done in the next iteration (next month, next week, depending on your time scale), move things there from Doing when you're waiting for feedback, add ~"Needs information" or ~"Needs review" here as well
  • Backlog: what will come Next once your Next is empty, move things there from Doing or Next if you're too busy
  • Not Scheduled: not planned, will be done at some point, but we don't know exactly when, move things there from the Backlog if your backlog becomes too large