| Interactive Media Design

GitHub Issues

Issues with GitHub! No, issues is a functionality in GitHub that allows us to manage out projects.

Issues in GitHub repository are used to report problems, document progress and milestones in the project. You can also use issues to tag your team mates to ask them for help or ask questions about certain areas of the repository.

Issues can also be used to add notes in the project or to create milestones in a project for project management purposes.

Issues tab

For creating an issue you will need to head over to the issues page from the repository navigation. Issues navigation link

I do not see issues tab!

If you do not see the issues link in the repository navigation you might have to turn on the issues for your repository.

Navigate to Settings > Options and check the box for issues. Issues option in settings

When you click on the issues link in the repository navigation you will see the issues page, this page will list any existing issues. You can click on an individual issue to see the details and edit it.

If this is your first time using issues this page will be empty and you can start by clicking the New issue button.

Issues new issue

Issue text and tagging

On the create issue page you can provide a title for your issue and write down the description of the issue in the editor below the title.

You can also tag users from GitHub using the @ symbol followed by their username to notify them about the issue. Tagging someone in the issue will send them an email and a notification on GitHub.

Issues text and tagging

Labels

Labels are a great way of categorizing your issues. They also make it easy for you and other users to navigate to certain type of issues by filtering with labels. To add a label click on the Labels option in the sidebar.

  • You can add one or more labels to an issue.
  • You can also create your custom labels on top of the defaults

Issues text and tagging

Other options

There are other options in an issue which can be used based on the needs of a project.

Assignees allows you to assign an issue to a team mate who also has access to this repository.

Projects allows you to assign this issue to a project inside the repository.

Milestone allows you to assign the issue to a milestone in the project. You will need to create a milestone first.

Submit and edit the issue

Once you have added the information you need for the issue you can click on Submit new issue button.

Issues text and tagging

After an issue is submitted you will be brought to the issue details page, this page will show you the information that you submitted in the issue and has options to:

  • edit the issue
  • add comments to the issue
  • close the issue once done

Issues text and tagging