Managing issues

WVS Issues are the fundamental medium for collaborating on ideas and planning work in WVS.

Key actions for issues include:

issues.

Create a new issue

When you create a new issue, you are prompted to fill in the data and fields of the issue. If you know the values you want to assign to an issue, you can use the Quick actions feature to input values.

Accessing the New Issue form

There are many ways to get to the New Issue form from a project’s page:

  • Navigate to your Project > Issues > New Issue:

  • From an open issue in your project, click the vertical ellipsis () button to open a dropdown menu, and then click New Issue to create a new issue in the same project:

  • From an issue board, create a new issue by clicking on the plus sign (+) at the top of a list. It opens a new issue for that project, pre-labeled with its respective list.

Elements of the New Issue form

When you’re creating a new issue, these are the fields you can fill in:

  • Title
  • Description
  • Checkbox to make the issue confidential
  • Assignee
  • Due date
  • Milestone
  • Labels

New issue from the group-level issue tracker

To visit the issue tracker for all projects in your group:

  1. Go to the group dashboard.
  2. On the left sidebar, select Issues.
  3. In the top-right, select the Select project to create issue button.
  4. Select the project you’d like to create an issue for. The button now reflects the selected project.
  5. Select the button to create an issue in the selected project.

The project you selected most recently becomes the default for your next visit. This should save you a lot of time and clicks, if you mostly create issues for the same project.

Bulk edit issues at the project level

Users with permission level of Reporter or higher can manage issues.

When bulk editing issues in a project, you can edit the following attributes:

To update multiple project issues at the same time:

  1. In a project, go to Issues > List.
  2. Click Edit issues. A sidebar on the right-hand side of your screen appears with editable fields.
  3. Select the checkboxes next to each issue you want to edit.
  4. Select the appropriate fields and their values from the sidebar.
  5. Click Update all.

Bulk edit issues at the group level

Users with permission level of Reporter or higher can manage issues.

When bulk editing issues in a group, you can edit the following attributes:

To update multiple project issues at the same time:

  1. In a group, go to Issues > List.
  2. Click Edit issues. A sidebar on the right-hand side of your screen appears with editable fields.
  3. Select the checkboxes next to each issue you want to edit.
  4. Select the appropriate fields and their values from the sidebar.
  5. Click Update all.

Moving issues

Moving an issue copies it to the target project, and closes it in the originating project. The original issue is not deleted. A system note, which indicates where it came from and went to, is added to both issues.

The “Move issue” button is at the bottom of the right-sidebar when viewing the issue.

Closing issues

When you decide that an issue is resolved, or no longer needed, you can close the issue using the close button:

You can also close an issue from the issue boards by dragging an issue card from its list and dropping it into the Closed list.

Closing issues automatically

When a commit or merge request resolves issues, the issues can be closed automatically when the commit reaches the project’s default branch.

If a commit message or merge request description contains text matching a defined pattern, all issues referenced in the matched text are closed. This happens when the commit is pushed to a project’s default branch, or when a commit or merge request is merged into it.

For example, if Closes #4, #6, Related to #5 is included in a Merge Request description, issues #4 and #6 are closed automatically when the MR is merged, but not #5. Using Related to flags #5 as a related issue, but is not closed automatically.

If the issue is in a different repository than the MR, add the full URL for the issue(s):

Closes #4, #6, and https://wvs.io/<username>/<projectname>/issues/<xxx>

For performance reasons, automatic issue closing is disabled for the very first push from an existing repository.

Disabling automatic issue closing

The automatic issue closing feature can be disabled on a per-project basis in the project’s repository settings. Referenced issues are still displayed, but are not closed automatically.

The automatic issue closing is also disabled in a project if the project has the issue tracker disabled. If you want to enable automatic issue closing, make sure to enable WVS Issues.

This only applies to issues affected by new merge requests or commits. Already closed issues remain as-is. If issue tracking is enabled, disabling automatic issue closing only applies to merge requests attempting to automatically close issues within the same project. Merge requests in other projects can still close another project’s issues.

Change the issue type

Users with the Developer role can change an issue’s type. To do this, edit the issue and select an issue type from the Issue type selector menu:

Deleting issues

Users with the Owner role can delete an issue by editing it and selecting Delete issue.

Similar issues

To prevent duplication of issues for the same topic, WVS searches for similar issues when new issues are being created.

As you type in the title field of the New Issue page, WVS searches titles and descriptions across all issues to in the current project. Only issues you have access to are returned. Up to five similar issues, sorted by most recently updated, are displayed below the title box. GraphQL must be enabled to use this feature.

Troubleshooting

For Additional Support, Please reach out to us on our Discord or by Email.