Introduction

Overview

Teaching: 5 min
Exercises: 5 min

Questions

• What is issue tracking?

• Why is issue tracking useful?

Objectives

• Understand the purpose and benefits of issue trackers

• Become familiar with GitHub Issues

What is Issue Tracking?

Issue tracking is an activity that happens as part of Project Management. In this activity, a record is made of bugs, enhancements, and requests in such a way that the team is able to view and access the list of work to be done.

Issues are used to collaborate, solve problems, and plan work, which is enabled by software tools such as GitLab issues, Jira story boards, and GitHub issues.

Issue trackers can be internal (team-facing) or external (user-facing). In this lesson, students will learn about issue tracking through the use of GitHub Issues.

The Benefits of Issue Tracking

Issue tracking has numerous benefits. Some of the main ones are:

• Visibility: Work to be done is captured in one location where all team members can access it
• Collaboration: Issue trackers enable good project collaboration. Work can be captured, organized, managed, and discussed in a single location
• Transparency: If the issue tracking system is user-facing, users can see the status of work completed and add more information

GitHub Issues

Numerous different issue tracking systems exist - both commercial and open-source, integrated and stand-alone.

GitHub integrates issue tracking into their version control system. Every project on GitHub can enable an integrated issue tracker.

To access a repository’s issues, simply navigate to the repository root page and click on “Issues” in the navigation bar. This will take you to the page of all “Open” issues.

Click on an issue to open it and read its details, plus any discussion on that issue.

You can also change the default filter on the Issues page by status (“Open” or “Closed”), author, and more.

Browsing Open Issues

Navigate to https://github.com/spack/spack and find the issues page.

• How many issues are currently open?
• How many have been closed?
• How many labels are there?

Key Points

• Issue tracking is the process of monitoring problems and requests for a software product.

• Issue tracking enables a software development team to capture, organize, and manage work collaboratively.