GitLab 101 training: login and issues¶
This GitLab training is a short (30-45min) hands-on training to get you up to speed with:
- accessing GitLab
- finding projects and documentation
- filing issues
GitLab is a powerful collaboration platform widely used by our engineering teams to develop and maintain software. It is also an essential organizational tool for coordinating work across teams — including operations, fundraising, and communications. It’s very important that everyone at Tor feels included in the same system and not working in parallel ones.
When you use GitLab, you’ll see features designed for software development, but your primary focus will be on GitLab’s task-tracking and collaboration capabilities. GitLab is our shared platform for tracking work, collaborating across teams, and keeping projects organized.
This onboarding guide will help you become comfortable using GitLab in your day-to-day work, ensuring that we maintain a unified workflow and shared visibility across the organization. It will help you manage tasks, track progress, and stay connected with your teammates.
In other words, GitLab is not only a development platform — it is a shared system that supports teamwork and transparency for everyone.
Get Familiar with GitLab¶
Start by logging into GitLab and exploring the main areas of the interface.
This might requiring going through the password reset and two-factor authentication onboarding!
The dashboard shows your projects, assigned issues, and recent activity, there won't be much here in the beginning, but this is your entry point.
You can also find here your Todo items. Its important to stay on top of these, as this is where people will raise an issue that needs your attention.
Spend a few minutes clicking around to get a sense of how GitLab is organized — don’t worry, you can’t break anything!
Understanding Groups and Projects¶
Projects in GitLab are containers for related work — think of them like folders for tasks and discussions.
A Group is a collection of related projects, users, and subgroups that share common settings, permissions, and visibility to simplify collaboration and management.
- Each team or initiative (e.g., Operations, Fundraising, Events) will has its own project.
- Inside a project, you’ll find Issues, Boards, and sometimes Milestones that help track work.
- Use the Project overview to see what’s active and where your work fits in.
Filing your first issue¶
Issues are the heart of GitLab’s task management system.
We will be using anarcat's test project. In this exercise, you'll learn how to file an issue:
- Click on the "Issues" under "Plan"
- Click on the "New Item" button
- Write a clear title and description so others understand the context
- Learn about filing confidential issues and their importance (our projects are often public to the entire Internet!!)
- Use comments to share updates, ask questions, or add attachments
You can think of issues as living task — they hold everything about a piece of work in one place.
Closing the Loop¶
When a task or project is complete:
- Close the issue to mark it as done.
- Add a short comment summarizing the outcome or linking to any relevant materials.
Closing the issue, and providing details about the resolution helps us in the future when we need to go back and see what happened with an issue, it provides visibility into completed work, and it keeps the issue queue tidy.
Explore Collaboration and Notification Features¶
GitLab makes teamwork easy and transparent.
- Use @mentions to tag teammates and bring them into the conversation.
- Add attachments (like documents or images) or link to shared files in Nextcloud.
- Keep discussions in issues so updates and decisions are visible to everyone.
- Learn about notifications
Finding issues and projects again¶
Now that you've filed an issue, you might close the tab and have trouble finding it again. It can be hard to find what you are looking for in GitLab.
Sometimes, as well, you might not know where to file your issue. When lost, you should ask TPA for help (bookmark this link!).
A few tricks:
- the GitLab home page will have information about your latest tasks and to-do items
- the Main wiki (which is the main home page when you are not logged-in) has links to lots of documentation, places and teams inside GitLab
Exercise:
- try to close the tab and find your issue again
- when lost, file an issue with TPA
- bookmark the Main wiki and the TPA support page