[GitHub Issues]

GitHub gives you a great issue tracker built into every repository.

Just click on the "issues" tab on the right-hand side of the repo,

and you'll see a list of all the issues you have open.

Click on the "new issue" button to create a new one.

Type in a title for your issue and put as much information

in the comment section as you want.

♪(acoustic jazz trio music)♪

Remember, this is a comment box on GitHub.com, so you can

use GitHub Flavored Markdown in here.

If you don't know Markdown syntax, you can always click the link to get a

syntax cheat sheet. You should check back

on this cheat sheet every so often; sometimes we make enhancements

to the GitHub flavor. Use the "preview" tab

to check your work, then submit the issue.

If you have a lot of issues, you'll probably want

to organize them using labels. We give you a few labels to start off with,

but you should feel free to create whatever new ones help organize

your work in ways that make sense to you.

You can use labels to filter your view of the issues.

That list is always ordered by how recently

an issue has been commented on.

Anyone can participate in an issue by commenting on it.

If you want to draw the attention

of another team member to an issue, just @mention them.

They'll get a notification either by email or in the web notification center.

You can also add and subtract labels if the state of

the issue changes over time as work proceeds.

Anybody who has write access to the repo can assign an issue

to anybody else on the team.

When you're filtering your list of the issues,

you can limit the view by issues you've created, issues that

have been assigned to you, or issues where you've been mentioned.

If you have a big project that might involve lots of individual issues,

you can create a milestone to track them together.

♪(acoustic jazz trio music)♪

You can easily assign issues to milestones, then use

milestone progress to track the status of the big project.

When you're all done with an issue, just close it. It'll be in your

repository forever, but it'll stay out of your default lists,

and if it's involved in a milestone, milestone progress will

move ahead when you close that issue.

Issues work really well for traditional applications like bug reports and

feature requests, but if you think about it, you can use them

to organize any kind of activity or task-oriented discussion.

Issues are just one more thing that makes GitHub the place

for you to build, discuss, and ship software.

[GitHub Foundations Git Hub for Windows]

[Subscribe to GitHub Guides Subscribe to GitHub]

♪(acoustic jazz trio music)♪