Issue
Noun · Open Source
Definitions
Issue in software development is a tracked item representing a bug report, feature request, task, or discussion point in a project management system. On platforms like GitHub, GitLab, and Jira, issues serve as the primary mechanism for organizing and prioritizing development work. Each issue typically has a title, description, labels (bug, enhancement, good-first-issue), assignee, milestone, and comment thread. Issues create a transparent, searchable record of what needs to be done, what is in progress, and what has been completed. In open-source projects, issues enable community participation by allowing users to report problems and contributors to find work to take on. Good issue hygiene includes providing clear reproduction steps for bugs, defining acceptance criteria for features, linking related issues, and closing issues promptly when resolved. Issue templates help standardize the information provided. The concept bridges communication between users, developers, and project managers, making it one of the most important collaboration tools in software engineering.
In plain English: A report filed against a software project — describing a bug, requesting a feature, or asking a question. The to-do list of open-source development.
Etymology
- 1990s
- Bug tracking systems (Bugzilla, JIRA) formalize the concept of an 'issue' as a trackable unit of work or problem
- 2008
- GitHub launches with integrated issue tracking, merging code hosting and project management
- 2010s
- Issues become a communication channel — feature requests, questions, and debates all live in issue trackers