Issues
Track bugs, ideas and work in your repository — with labels, assignees, milestones, and conversations anyone with access can join.
Open an issue
From the repository's Issues tab, click New issue, give it a title and a body (markdown is rendered, so code blocks, lists and links all work), and submit. Every issue gets a number — #12 — that stays with it for the life of the repository, so links like #12 keep pointing at the same issue even as others open and close.
The issue page
An issue is a conversation: the original body first, then every comment below it. Anyone who can read the repository can comment. When the work is done, Close the issue — closed issues stay searchable and keep their number, and can be reopened if the problem comes back.
Labels
Labels categorize issues at a glance — bug, docs, needs-review. Every repository starts with a small set, and you can create your own from the Labels page (each with its own color). Apply as many as you like from the issue's sidebar; people with write access can add and remove labels at any time.
Assignees
Assignees are the people responsible for an issue — set them from the issue's sidebar by picking from the repository's collaborators and your organization's members. Assignment is a signal to humans and to your team's triage, not a lock: anyone with access can still comment and contribute.
Milestones
A milestone groups issues under a target — a version, a release, a date. Create milestones from the repository's Milestones page, optionally with a due date, and file issues under them from the sidebar. The milestone page shows a progress bar of open versus closed issues, so a release's remaining work is visible at a glance.
Finding issues
The Issues tab has Open and Closed views with counts, and the list is filterable — by label from the label list, or straight from the API and the CLI with the same filters (query, labels, milestone, sort).
Notifications
You are notified when someone @mentions you, when an issue you opened or commented on gets activity, and when you are assigned. Which categories reach your inbox versus stay in-app is up to you under Settings → Notifications.