Now that you're more familiar with the Board, let's take a look at creating issues and linking PR's in ZenHub!
|- Create an issue||✅|
|- Quickly create an issue||✅|
|- Understand how GitHub issue templates work||✅|
|- Set a pipeline for an issue and assign it to yourself or a team member||✅|
|- Connect a PR to an issue||✅|
In GitHub, issues take the place of user stories. These are high-level feature descriptions that help define benefit from a customer's perspective. Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.
User stories are high-level feature descriptions that help define benefit from a customer’s perspective. They're often written in this format, which is intended to keep things simple and focused on business value: As a user type, I want a goal so that benefit.
Creating an issue in ZenHub
To get started with creating an issue, select the green New issue button located in the top right of your board:
From here, you can give your new issue a title. Below the Issue title, you can provide a further description of what exactly the issue is. It's important to flesh out each Issue your team will be working on so that everyone understands exactly what is required.
The content and description support markdown and we recommend formatting these issues so that they are easily understood by the whole team. Learn more here
Quickly create new issues
You can also create a new issue for any specific pipeline in your Workspace. Navigate to the pipeline header, where there will be a + icon. Once pressed, you can quickly and easily create a new Issue that falls into that pipeline specifically. The issue will be created in the default repo for that Workspace.
To the right of the issue, there are a number of different attributes which can be applied to the issue. Let's take a look at these in further detail:
|Pipelines||Assign a pipeline for your Issue such as New Issues. ZenHub comes with 6 default pipelines which can be customized depending on your workflow|
|Labels||Add a label to your issue. Labels are a core GitHub functionality and therefore ZenHub uses a GitHub repo's native label set to populate what available labels exist when navigating issues in ZenHub. To create new labels check out our article here|
|Assignees||Assign the issue to a member of your team. You can assign up to ten people to an issue|
|Sprints||Add the issue to a ZenHub sprint. Sprints allow you to automate your sprint planning process. Learn more here|
|Milestone||**Only available for on-premise accounts** A GitHub milestone is a fixed length of time when an agreed-upon amount of work will be completed. (Note: ZenHub Sprints are a new entity that we'd recommend using for organizing Sprints)|
|Estimate||Assign a story point estimate to your issue. Story point estimates are unitless scales of measurement which are used to size tasks in comparison to other tasks|
|Epics||Attach the issue to an epic. Epics are a theme of work that contain subtasks required to complete the larger goal|
|Releases||Add your issue to a release. A release can be considered as a long-term goal or a big objective. The project work may be dynamically changing and it may span multiple sprints|
Next, let's take a look at using issue templates. When creating a new issue you can also choose an issue template from the dropdown. These templates can be used in ZenHub Workspaces to help organize work and ensure the right details are being captured in various scenarios:
Issue templates are a core GitHub functionality
It's important to be aware that Issue templates can only be created from within the GitHub repository. You must be a GitHub repository administrator in order to create Issue templates.
Once your issue templates are live in GitHub they will be available from the issue template dropdown when creating new Issues. Check out more on creating Issue Templates here
Once you are happy with your Issue and ready to add it to the board, select Submit new Issue
To move an Issue across pipelines, simply select the issue and drag it to the destination pipeline. From here you can drop the issue into the pipeline.
Selecting multiple issues in the Workspace will trigger the Multi-Action action bar allowing you to perform bulk updates to issues instantly. You can select multiple issues by clicking a user avatar to select the first issue. Once your first issue is selected, you can continue selecting additional issues. Once you've selected all relevant issues, find the bulk action you want to perform at the top of your Workspace:
You'll notice that the issues remain selected so that you can make additional updates if needed. Click either “Done”, “Clear All” at the top-left corner of the Workspace, or unselect all of the issues by clicking on them again to exit selection mode completely.
Connecting pull requests to issues
When creating pull requests in GitHub you will be able to choose a default board pipeline for the PR to land in. You can also connect the PR to an existing issue. This will pull the issue into the same pipeline as the PR! Check our more on Issue and PR linking here
You're all set! You are now up and running with creating issues. Time to start collaborating with your team and builder better software!