This is a work in progress for the Marketing Project Management Simplification project.
Issues are a core building block in GitLab that enable collaboration, discussions, planning and tracking of work.
Issues are typically used to
Because issues can serve so many purposes and roles in GitLab, understanding where they exist and how to best utilize them is incredibly important.
The top section of an issue is the body of the issue - the "Description" In the "Description", is where the core themes and topics of the issue is captured. It is not uncommon to find lengthy issue descriptions, which are used to capture the most current status of the issue.
Because the issue discussions can be long and flowing, often a best practice is to update the description with the most current/ up to date content.
There are many detailed parts of an issue. such as:
Review the Issue Data and Actions documentation for more details on these and more.
In each project, a set of "Issue Templates" can be defined to make it easy to create common issues for different situations or problems.
Issues enable and support discussions on images and designs with Design Management. Design management makes it very useful in reviewing graphics and design work asynchronously.
Issues, Merge Requests and Epics all support the ability to use keyboard shortcuts trigger key actions in the issue, MR or epic.
Quick Actions are effectively commands that make it easy and efficient to change an issue such as:
/label followed by the label name will add a label.
'/assign' followed by a user ID, will assign the issue to a person
/close will close an issue
/epic followed by an epic ID will assign the issue to an epic
and so on.
Issues can be either open or confidential.
In the Markdown language that is used to write the description and comments in issues it is possible to create lists of items that work as checkboxes - a list of
task lists are a relatively simple list of items that can be 'checked off'.
In order to manage interdependency between issues, it is possible to create several types of relationships between issues:
With issue relationships, it is possible to create a series of tasks/issues where there is a sequential requirement that one issue is completed before the following issues are completed.
Define and use Issue Templates for any repetitive types of issues that a team/project will need.
The issue template can be accessed directly through a URL such as
Where the first half of the URL is the link to the project and then
new?issuable_template= followed by the name of the template.
Use Quick Actions in the issue template to ensure that the issues have the appropriate
milestones associated with the issue.
Issue discussions can be lengthy and exhaustive. As a best practice, update issue descriptions with the most current status and information. For example, if a discussion thread results in a better answer or improved part of the description - update the description. Don't force everyone to read the entire thread and history in order to understand the current status of the issue.
Issues maintain a history of the changes to the descriptions, so update descriptions when it makes sense.