Say it like this
- We have a critical issue with the payment system
- Can you take this issue and start working on it?
- This issue has been resolved and can be closed
- The issue tracker shows we're behind schedule
- Let me file an issue for that
Use it at work
Reporting
- I've opened an issue on GitHub.
- There's an issue with the login page.
Triaging
- Is this issue a bug or a feature request?
- Let's close issues that are older than a year.
Raising concerns
- One issue: we don't have tests for this.
- I don't see any issues with the plan.
Don't say this
In this context, issue is the problem itself, not something you do to it. To issue something means to distribute or release it.
Don't mix it up
| Term | What it is | Who writes or uses it | When |
|---|---|---|---|
| issue | Any problem or ticket | Anyone | GitHub, Jira |
| bug | Something broken in code | Developers, QA | Errors |
| problem | General difficulty | Anyone | Any context |
Practice
Try it
4 quick exercises
1. Your team found a memory leak in the API. What do you say in standup?
2. I will _______ this bug as an issue in our tracking system so the team can see it.
3. Which sentence uses issue incorrectly?
4. Rewrite this in natural tech English: The team found a problem with the login page that we wrote down and need to fix it soon.
Say it out loud
Phrase 1 of 5
"We have a critical issue with the payment system"
We don't save your recording. The word check uses your browser's speech recognition.
More about issue
Real examples(5)
- in a standup
"I completed three issues yesterday and I'm blocked on issue #234 because we need design approval."
- in a code review
"This pull request closes issue #156, which was about improving the database query performance."
- in a team meeting
"We need to prioritize the critical issues first before moving to the nice-to-have feature requests."
- in a Slack message
"I created a new issue for the login timeout bug. Please add your feedback to the discussion."
- in a retrospective
"We closed 32 issues this sprint, which is 8 more than last sprint."
More mistakes(3)
Handle with care. Do not confuse with issue as a verb meaning to distribute or give out. In tech, issue typically refers to a problem or ticket, not the act of releasing something.
- ✕There are many issues about this in the documentation.✓There are many problems with this that we documented.
Issues are tracked items in a system. If you are referring to general problems mentioned in docs, use problem or concern instead.
- ✕This issue is not important enough to work on.✓This issue doesn't have high enough priority to work on now.
Every issue has value; the concern is about priority level, not importance of the issue itself.
- ✕I resolved the issue yesterday but did not close it.✓I fixed the issue yesterday and closed it.
Resolved and fixed are similar, but close is the standard verb for marking an issue as complete in tracking systems.
Other forms(3)
- issue noun
"The issue was discovered during testing."
- issues (plural) noun
"We have fifty open issues in our backlog."
- to issue (distribute/release) verb
"We will issue the new version tomorrow. (Note: This is different from the tech planning sense)"
Often used with(8)
- open issue · An issue that has not yet been resolved or closed
- critical issue · A high-priority issue that blocks work or affects users severely
- close an issue · To mark an issue as complete or resolved in a tracking system
- assign an issue · To give an issue to a specific team member to work on
- file an issue · To create or submit a new issue in a tracking system
- track issues · To monitor and manage issues in a system like Jira or GitHub
- known issue · A problem that has been identified and documented
- blocking issue · An issue that prevents other work from being completed
Similar words(4)
- bug · More specific; refers only to errors or defects in code. Issue is broader and includes features and tasks.
- ticket · Used interchangeably with issue in many companies, but ticket is more informal and broader.
- task · Similar, but task is more general. Issue is typically tracked in a formal system with more metadata.
- problem · General English term. Issue is the industry standard in tech project management.
Opposites(2)
- resolution
- fix
Questions(5)
- What is the difference between an issue and a bug?
- A bug is a type of issue that describes a defect or error in code. An issue is broader and can be a bug, feature request, documentation task, or any other unit of work tracked by the development team.
- How do you use issue in a sentence at work?
- Use it as a noun when referring to tracked problems or tasks: I am working on issue #456, which is about improving API response time. Or in conversations: We have several open issues that need to be resolved before the release.
- Is issue formal or informal?
- Issue is neutral and professional. It is the standard term used in formal project management, code reviews, and documentation, as well as in casual standup meetings and Slack conversations.
- What does it mean to close an issue?
- To close an issue means to mark it as complete or resolved in your tracking system (like Jira or GitHub). Once an issue is closed, it no longer appears in the active work list.
- Can you use issue as a verb in tech?
- In general English, to issue means to distribute or release something. However, in tech, we rarely use it this way. We use file an issue, create an issue, or close an issue instead.
