Issue

Noun · Open Source

Definitions

  1. 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

Related Terms