Learn how to work with issues in Volta.
Volta's main goal is to provide a solution on top of GitHub issues. Issues and pull requests are tied to a repository and imported when you install our GitHub app.
Volta and GitHub are tightly integrated, everything you do on one will be reflected on the other. Volta provides most of GitHub features and simply brings its own touch on top of it.
You might be familiar with properties like comments, reactions, assignees, reviewers and labels from GitHub, here is what Volta adds:
Status
The status
of an issue comes in addition of the GitHub state
(open or closed) and is used to provide an automated issue board out of the box for your repositories.
Milestones
You can attach project and repository milestones to an issue to organize and track progress.
Volta milestones are not synced with GitHub, learn more about them.Due date
You can set a due date on an issue, which will be displayed in the board and list views in red when overdue and in orange when due within the week.
Tag
You can attach a repository tag to an issue in Done or Released status. This will automatically move the issue to Released if not already.
When a new tag is pushed to your repository, all issues in Done status will be automatically moved to Released status and linked to the tag.When creating or editing an issue, selecting properties like repository
, labels
, assignees
and reviewers
will be saved in an history. Those properties will be sorted by most used next time you select them.
You can find issue actions in the menu:
Issue
.You can archived closed issues to hide them from the board, list and timeline views from the actions menu or by using the command menu action.
You can subscribe to an issue to receive notifications when new activities happen from the actions menu, by clicking on the button in the Activity
section or by using the command menu action.
You will also find a subscribe menu in the Activity
section where as a maintainer you can subscribe other users to the issue. This will send a Subscribe
notification to the user.
To create a new issue, you can click on the button in the sidebar. This button will open a modal where you can choose the repository you want to create the issue in. You can also use the command menu action or press C.
You will be able to select the status
of the issue, a due date
, labels
, milestones
and assignees
. You can also add a title
and a description
using our markdown editor.
To edit an issue, you can click on the button in the actions menu, use the command menu action or press E. You will enter edit mode and all your changes will be saved automatically in a draft. You can then save your changes by clicking on or by pressing S / Enter to update the issue.
Learn more about the draft system of our markdown editor.You can also directly update the status
, due date
, tag
, labels
, milestones
, assignees
and reviewers
of the issue without entering edit mode from the right panel.
status
, labels
, milestones
, assignees
and reviewers
through the command menu K by typing Change
or through their respective shortcut S, L, M, A and R.When on a repository, project or user page, you can view issues in different ways.
You can switch between board, list and timeline views by clicking on the button in the header, by using the command menu action or by pressing the V shortcut to cycle through views.
You can display your timeline in split view on the board or list.Search issues by typing in the input above the view. You can press F to focus the search input.
Learn how to use the search menu to find closed or archived issues.Filter issues by almost any property by clicking on the button above the view.
You can also quickly filter by label
by clicking on or badges for example.