Issue boards

Learn how issue boards automate your issues and pull requests.

Overview

The issue board is a powerful tool to help you manage your issues and pull requests. It's a real-time view of your issues and pull requests, with a simple drag and drop interface to move them between columns.

A board is based on pre-defined statuses: Triage Todo In Progress In Review Done Released Cancelled.

Repositories

Once your repositories are imported into Volta, you can navigate to any repository from the aside or command palette to access its issue board.

By default after an import, all open issues will be added to the Triage column, except for issues that are linked to open pull requests, those will be added to the In Progress or In Review column depending on the pull request state.

Even if Volta imports all your issues and pull requests from GitHub, you will only see the ones that are open or already have a status.

Users

You can also navigate to the Issues tab to view your personal board. User boards are a little different from repositories as they will show you issues that you're assigned, pull requests that you're the author of or requested as a reviewer.

This also works for any user, you will only see issues from repositories you're also a maintainer of. You can navigate to any user's board through the command palette or through url with usernames, ex: https://volta.net/Atinux.

Features

References

Like on GitHub, you can link a pull request to an issue by using a supported keyword in the pull request's description: close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved.

The syntax for closing keywords depends on whether the issue is in the same repository as the pull request:

  • Closes #10 to close issue 10 in the same repository
  • Fixes volta-net/feeedback#10 to close issue 10 in the volta-net/feeedback repository
  • Resolves volta-net/feeedback#10, resolves #20 to close issue 10 in the volta-net/feeedback repository and issue 20 in the same repository

When merging the pull request, GitHub will automatically close the referenced issues. Volta will automatically move the referenced issues to the Done status but only if all the pull requests linked to the issue are merged.

To unlink an issue that you linked using a keyword, you must edit the pull request description to remove the keyword.

You can also use closing keywords in a commit message. The issue will be closed when the commit is pushed to the default branch.

Automation

Thanks to our GitHub app and real-time sync with GitHub, Volta can automatically move issues and pull requests between columns:

Triage
  • When a pull request in the board gets linked to an issue, its status will be reset to Triage
Linked pull requests are locked into the Triage column as you should already see the issues they are linked to in the In Progress or In Review columns. Once merged those linked pull requests disappear from the Triage column.
In Progress
  • When a pull request is linked to the issue
Additionally, you will automatically be assigned to an issue when moving it to In Progress if no one is assigned to it.
In Review
  • When someone requests a review on a linked pull request
Done
  • When all the linked pull requests are merged
  • When a commit is pushed to the default branch with a closing keyword (the commit sha will be displayed in the activity)
Released
  • When a new tag is pushed, all issues in the Done status will be moved and attached to the tag
  • When the issue is Done and a tag is manually attached to it

We also synchronize the state of the issue on GitHub when you move it on the board:

  • When an issue is moved to the Done column it will automatically be closed on GitHub as Completed
  • When an issue is moved to the Cancelled column it will automatically be closed on GitHub as Not Planned

Drag and drop

You can drag and drop issues and pull requests between columns to move them, you can also drag and drop issues vertically within a column to reorder your issues. Except for linked pull requests locked into the Triage column that you can only drag vertically.

Hide columns

You can hide a column by clicking on the button on the top right of each list. Also, a View button is available on every board page to quickly select which columns you want to see.

Archive closed issues

You can archive closed issues by clicking on the button on the top right of each list. If the issue is reopened, it will be automatically unarchived and will then reappear in the board.

When you archive issues, you will not be able to see them on the board anymore. However, you can still access them through url.

A search feature to find archived issues will be coming soon.