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