Issues are the building blocks of any Jira Software project. Each issue represents a story, bug, feature request, or other item in your project’s workflow. You can use issues to plan your work, collaborate with teammates and outside collaborators, and track team progress. You can create issues in a variety of ways, customized to your organization’s needs and workflow. You can also view and manage multiple projects’ issues in a single board.
How to Write About an Issue
When writing about an issue, it’s important to keep your readers in mind. Consider the subject you are writing about, and decide if your audience will find it interesting or helpful. Then, choose a unique angle that is relevant to your topic.
If you are unsure of how to write about an issue, start by creating an outline. Outlines help you organize your ideas and thoughts into sections and subsections. You can use a tool like Google Docs or Workflowy to create an outline, and you can customize it to meet your needs.
If you are writing a troubleshooting article, you will want to include steps that address a specific problem. Ideally, you will provide more than one solution, but each should be clearly defined and easy to follow. For example, if you are writing about how to fix a broken computer, you will likely want to include several options for fixing it, such as replacing the motherboard or installing new software.