Issues, Projects, and GitHub Collaboration Features

Issues, Projects, and GitHub Collaboration Features

GitHub Issues is a built-in issue tracker that teams use to report bugs, request features, and plan work. Combined with GitHub Projects, it provides a lightweight project management system directly integrated with your code.

Creating and Using Issues

Issues can contain text, images, code blocks, checklists, and file attachments. Use labels like bug, enhancement, and documentation to categorize them. Assign issues to team members and set milestones to group related issues by release or sprint.

Closing Issues via Commits

Including certain keywords in a commit message or PR description automatically closes linked issues when merged to the default branch:

git commit -m "Fix login redirect loop. Closes #42"

Keywords that trigger auto-closing: Closes, Fixes, Resolves, followed by the issue number.

Issue and PR Templates

Create template files in the .github/ISSUE_TEMPLATE/ directory to provide structured forms for bug reports and feature requests. This improves the quality of issues and saves time for maintainers.

GitHub Projects

GitHub Projects provides Kanban-style boards and table views for managing work. You can create custom fields, automate card movement based on PR and issue status, and link projects to repositories or organizations for cross-repo planning.

Mentions and Notifications

Use @username in any comment or description to notify a specific person. Use @team-name to notify an entire team. Manage your notification preferences to avoid inbox overload on large projects.