Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
2a4d5db2
Commit
2a4d5db2
authored
Dec 16, 2021
by
Marcin Sedlak-Jakubowski
Committed by
David O'Regan
Dec 16, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
CTRT edits to managing issues
parent
cb075f8f
Changes
12
Show whitespace changes
Inline
Side-by-side
Showing
12 changed files
with
211 additions
and
141 deletions
+211
-141
app/views/projects/default_branch/_show.html.haml
app/views/projects/default_branch/_show.html.haml
+1
-1
doc/user/group/epics/manage_epics.md
doc/user/group/epics/manage_epics.md
+1
-1
doc/user/permissions.md
doc/user/permissions.md
+1
-0
doc/user/project/issues/csv_import.md
doc/user/project/issues/csv_import.md
+1
-1
doc/user/project/issues/img/button_close_issue_v13_6.png
doc/user/project/issues/img/button_close_issue_v13_6.png
+0
-0
doc/user/project/issues/img/disable_issue_auto_close.png
doc/user/project/issues/img/disable_issue_auto_close.png
+0
-0
doc/user/project/issues/img/issue_type_change_v13_12.png
doc/user/project/issues/img/issue_type_change_v13_12.png
+0
-0
doc/user/project/issues/img/merge_request_closes_issue_v13_11.png
.../project/issues/img/merge_request_closes_issue_v13_11.png
+0
-0
doc/user/project/issues/img/sidebar_move_issue.png
doc/user/project/issues/img/sidebar_move_issue.png
+0
-0
doc/user/project/issues/img/similar_issues.png
doc/user/project/issues/img/similar_issues.png
+0
-0
doc/user/project/issues/index.md
doc/user/project/issues/index.md
+2
-2
doc/user/project/issues/managing_issues.md
doc/user/project/issues/managing_issues.md
+205
-136
No files found.
app/views/projects/default_branch/_show.html.haml
View file @
2a4d5db2
...
@@ -26,6 +26,6 @@
...
@@ -26,6 +26,6 @@
%strong
=
_
(
"Auto-close referenced issues on default branch"
)
%strong
=
_
(
"Auto-close referenced issues on default branch"
)
.form-text.text-muted
.form-text.text-muted
=
_
(
"When merge requests and commits in the default branch close, any issues they reference also close."
)
=
_
(
"When merge requests and commits in the default branch close, any issues they reference also close."
)
=
link_to
sprite_icon
(
'question-o'
),
help_page_path
(
'user/project/issues/managing_issues.md'
,
anchor:
'
disabling-automatic-issue-closing
'
),
target:
'_blank'
=
link_to
sprite_icon
(
'question-o'
),
help_page_path
(
'user/project/issues/managing_issues.md'
,
anchor:
'
closing-issues-automatically
'
),
target:
'_blank'
=
f
.
submit
_
(
'Save changes'
),
class:
"gl-button btn btn-confirm"
,
data:
{
qa_selector:
'save_changes_button'
}
=
f
.
submit
_
(
'Save changes'
),
class:
"gl-button btn btn-confirm"
,
data:
{
qa_selector:
'save_changes_button'
}
doc/user/group/epics/manage_epics.md
View file @
2a4d5db2
...
@@ -332,7 +332,7 @@ Only issues from projects that are in groups can be promoted. When you attempt t
...
@@ -332,7 +332,7 @@ Only issues from projects that are in groups can be promoted. When you attempt t
issue, a warning is displayed. Promoting a confidential issue to an epic makes all information
issue, a warning is displayed. Promoting a confidential issue to an epic makes all information
related to the issue public as epics are public to group members.
related to the issue public as epics are public to group members.
When
the quick action is executed
:
When
an issue is promoted to an epic
:
-
An epic is created in the same group as the project of the issue.
-
An epic is created in the same group as the project of the issue.
-
Subscribers of the issue are notified that the epic was created.
-
Subscribers of the issue are notified that the epic was created.
...
...
doc/user/permissions.md
View file @
2a4d5db2
...
@@ -103,6 +103,7 @@ The following table lists project permissions available for each role:
...
@@ -103,6 +103,7 @@ The following table lists project permissions available for each role:
|
[
Issues
](
project/issues/index.md
)
:
<br>
View related issues | ✓ | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
View related issues | ✓ | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Set weight | ✓ (
*16*
) | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Set weight | ✓ (
*16*
) | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
View
[
confidential issues
](
project/issues/confidential_issues.md
)
| (
*2*
) | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
View
[
confidential issues
](
project/issues/confidential_issues.md
)
| (
*2*
) | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Close / reopen | | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Lock threads | | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Lock threads | | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Manage related issues | | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Manage related issues | | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Manage tracker | | ✓ | ✓ | ✓ | ✓ |
|
[
Issues
](
project/issues/index.md
)
:
<br>
Manage tracker | | ✓ | ✓ | ✓ | ✓ |
...
...
doc/user/project/issues/csv_import.md
View file @
2a4d5db2
...
@@ -10,7 +10,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
...
@@ -10,7 +10,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
Issues can be imported to a project by uploading a CSV file with the columns
Issues can be imported to a project by uploading a CSV file with the columns
`title`
and
`description`
. Other columns are
**not**
imported. If you want to
`title`
and
`description`
. Other columns are
**not**
imported. If you want to
retain columns such as labels and milestones, consider the
[
Move Issue feature
](
managing_issues.md#mov
ing-issues
)
.
retain columns such as labels and milestones, consider the
[
Move Issue feature
](
managing_issues.md#mov
e-an-issue
)
.
The user uploading the CSV file is set as the author of the imported issues.
The user uploading the CSV file is set as the author of the imported issues.
...
...
doc/user/project/issues/img/button_close_issue_v13_6.png
deleted
100644 → 0
View file @
cb075f8f
22.5 KB
doc/user/project/issues/img/disable_issue_auto_close.png
deleted
100644 → 0
View file @
cb075f8f
14.8 KB
doc/user/project/issues/img/issue_type_change_v13_12.png
deleted
100644 → 0
View file @
cb075f8f
16.5 KB
doc/user/project/issues/img/merge_request_closes_issue_v13_11.png
deleted
100644 → 0
View file @
cb075f8f
15.1 KB
doc/user/project/issues/img/sidebar_move_issue.png
deleted
100644 → 0
View file @
cb075f8f
48.8 KB
doc/user/project/issues/img/similar_issues.png
deleted
100644 → 0
View file @
cb075f8f
24.8 KB
doc/user/project/issues/index.md
View file @
2a4d5db2
...
@@ -32,8 +32,8 @@ To learn how the GitLab Strategic Marketing department uses GitLab issues with [
...
@@ -32,8 +32,8 @@ To learn how the GitLab Strategic Marketing department uses GitLab issues with [
-
[
Create issues
](
managing_issues.md#create-an-issue
)
-
[
Create issues
](
managing_issues.md#create-an-issue
)
-
[
Create an issue from a template
](
../../project/description_templates.md#use-the-templates
)
-
[
Create an issue from a template
](
../../project/description_templates.md#use-the-templates
)
-
[
Edit issues
](
managing_issues.md#edit-an-issue
)
-
[
Edit issues
](
managing_issues.md#edit-an-issue
)
-
[
Move issues
](
managing_issues.md#mov
ing-issues
)
-
[
Move issues
](
managing_issues.md#mov
e-an-issue
)
-
[
Close issues
](
managing_issues.md#clos
ing-issues
)
-
[
Close issues
](
managing_issues.md#clos
e-an-issue
)
-
[
Delete issues
](
managing_issues.md#delete-an-issue
)
-
[
Delete issues
](
managing_issues.md#delete-an-issue
)
-
[
Promote issues
](
managing_issues.md#promote-an-issue-to-an-epic
)
-
[
Promote issues
](
managing_issues.md#promote-an-issue-to-an-epic
)
-
[
Set a due date
](
due_dates.md
)
-
[
Set a due date
](
due_dates.md
)
...
...
doc/user/project/issues/managing_issues.md
View file @
2a4d5db2
...
@@ -52,7 +52,7 @@ to the projects in the group.
...
@@ -52,7 +52,7 @@ to the projects in the group.
Prerequisites:
Prerequisites:
-
You must have at least the
[
Guest role
](
../../permissions.md
)
for
a
project in the group.
-
You must have at least the
[
Guest role
](
../../permissions.md
)
for
the
project in the group.
To create an issue from a group:
To create an issue from a group:
...
@@ -224,170 +224,191 @@ You can edit an issue's title and description.
...
@@ -224,170 +224,191 @@ You can edit an issue's title and description.
Prerequisites:
Prerequisites:
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for
a
project.
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for
the
project.
To edit an issue
, select
**Edit title and description**
(
**{pencil}**
).
To edit an issue
:
### Bulk edit issues at the project level
1.
To the right of the title, select
**Edit title and description**
(
**{pencil}**
).
1.
Edit the available fields.
1.
Select
**Save changes**
.
> - Assigning epic ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/210470) in GitLab 13.2.
### Bulk edit issues from a project
> - Assigning epic [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/210470) in GitLab 13.2.
> - Editing health status [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/218395) in GitLab 13.2.
> - Editing health status [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/218395) in GitLab 13.2.
> - Editing iteration [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/196806) in GitLab 13.9.
> - Editing iteration [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/196806) in GitLab 13.9.
Users with permission level of
[
Reporter or higher
](
../../permissions.md
)
can manage issues.
You can edit multiple issues at a time when you're in a project.
Prerequisites:
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
To edit multiple issues at the same time:
1.
On the top bar, select
**Menu > Projects**
and find your project.
1.
On the left sidebar, select
**Issues**
.
1.
Select
**Edit issues**
. A sidebar on the right of your screen appears.
1.
Select the checkboxes next to each issue you want to edit.
1.
From the sidebar, edit the available fields.
1.
Select
**Update all**
.
When bulk editing issues in a project, you can edit the following attributes:
When bulk editing issues in a project, you can edit the following attributes:
-
Status (open
/
closed)
-
Status (open
or
closed)
-
Assignee
-
[
Assignees
](
#assignee
)
-
[
Epic
](
../../group/epics/index.md
)
-
[
Epic
](
../../group/epics/index.md
)
-
[
Milestone
](
../milestones/index.md
)
-
[
Milestone
](
../milestones/index.md
)
-
[
Labels
](
../labels.md
)
-
[
Labels
](
../labels.md
)
-
[
Health status
](
#health-status
)
-
[
Health status
](
#health-status
)
-
Notification
subscription
-
[
Notification
](
../../profile/notifications.md
)
subscription
-
[
Iteration
](
../../group/iterations/index.md
)
-
[
Iteration
](
../../group/iterations/index.md
)
To update multiple project issues at the same time:
### Bulk edit issues from a group
1.
In a project, go to
**Issues > List**
.
1.
Click
**Edit issues**
. A sidebar on the right-hand side of your screen appears with editable fields.
1.
Select the checkboxes next to each issue you want to edit.
1.
Select the appropriate fields and their values from the sidebar.
1.
Click
**Update all**
.
### Bulk edit issues at the group level
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7249) in GitLab 12.1.
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7249) in GitLab 12.1.
> - Assigning epic
(
[introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/210470) in GitLab 13.2.
> - Assigning epic [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/210470) in GitLab 13.2.
> - Editing health status [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/218395) in GitLab 13.2.
> - Editing health status [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/218395) in GitLab 13.2.
> - Editing iteration [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/196806) in GitLab 13.9.
> - Editing iteration [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/196806) in GitLab 13.9.
Users with permission level of
[
Reporter or higher
](
../../permissions.md
)
can manage issues.
You can edit multiple issues across multiple projects when you're in a group.
Prerequisites:
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for a group.
To edit multiple issues at the same time:
1.
On the top bar, select
**Menu > Groups**
and find your group.
1.
On the left sidebar, select
**Issues**
.
1.
Select
**Edit issues**
. A sidebar on the right of your screen appears.
1.
Select the checkboxes next to each issue you want to edit.
1.
From the sidebar, edit the available fields.
1.
Select
**Update all**
.
When bulk editing issues in a group, you can edit the following attributes:
When bulk editing issues in a group, you can edit the following attributes:
-
[
Epic
](
../../group/epics/index.md
)
-
[
Epic
](
../../group/epics/index.md
)
-
[
Milestone
](
../milestones/index.md
)
-
[
Milestone
](
../milestones/index.md
)
-
[
Iteration
](
../../group/iterations/index.md
)
-
[
Labels
](
../labels.md
)
-
[
Labels
](
../labels.md
)
-
[
Health status
](
#health-status
)
-
[
Health status
](
#health-status
)
-
[
Iteration
](
../../group/iterations/index.md
)
To update multiple project issues at the same time:
## Move an issue
1.
In a group, go to
**Issues > List**
.
When you move an issue, it's closed and copied to the target project.
1.
Click
**Edit issues**
. A sidebar on the right-hand side of your screen appears with editable fields.
1.
Select the checkboxes next to each issue you want to edit.
1.
Select the appropriate fields and their values from the sidebar.
1.
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
The original issue is not deleted. A system note, which indicates
where it came from and went to, is added to both issues.
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.
Prerequisites:
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
To move an issue:
1.
Go to the issue.
1.
On the right sidebar, select
**Move issue**
.
1.
Search for a project to move the issue to.
1.
Select
**Move**
.
### Bulk move issues **(FREE SELF)**
You can move all open issues from one project to another.
![
move issue - button
](
img/sidebar_move_issue.png
)
Prerequisites:
### Moving issues in bulk **(FREE SELF)**
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
If you have advanced technical skills you can also bulk move all the issues from
To do it:
one project to another in the rails console. The below script moves all issues
that are not in status
**closed**
from one project to another.
To access rails console run
`sudo gitlab-rails console`
on the GitLab server and run the below
1.
Optional (but recommended).
[
Create a backup
](
../../../raketasks/backup_restore.md
)
before
script. Please be sure to change
`project`
,
`admin_user`
, and
`target_project`
to your values.
attempting any changes in the console.
We do also recommend
[
creating a backup
](
../../../raketasks/backup_restore.md
)
before
1.
Open the
[
Rails console
](
../../../administration/operations/rails_console.md
)
.
attempting any changes in the console.
1.
Run the following script. Make sure to change
`project`
,
`admin_user`
, and
`target_project`
to
your values.
```
ruby
```
ruby
project
=
Project
.
find_by_full_path
(
'full path of the project where issues are moved from'
)
project
=
Project
.
find_by_full_path
(
'full path of the project where issues are moved from'
)
issues
=
project
.
issues
issues
=
project
.
issues
admin_user
=
User
.
find_by_username
(
'username of admin user'
)
# make sure user has permissions to move the issues
admin_user
=
User
.
find_by_username
(
'username of admin user'
)
# make sure user has permissions to move the issues
target_project
=
Project
.
find_by_full_path
(
'full path of target project where issues moved to'
)
target_project
=
Project
.
find_by_full_path
(
'full path of target project where issues moved to'
)
issues
.
each
do
|
issue
|
issues
.
each
do
|
issue
|
if
issue
.
state
!=
"closed"
&&
issue
.
moved_to
.
nil?
if
issue
.
state
!=
"closed"
&&
issue
.
moved_to
.
nil?
Issues
::
MoveService
.
new
(
project
,
admin_user
).
execute
(
issue
,
target_project
)
Issues
::
MoveService
.
new
(
project
,
admin_user
).
execute
(
issue
,
target_project
)
else
else
puts
"issue with id:
#{
issue
.
id
}
and title:
#{
issue
.
title
}
was not moved"
puts
"issue with id:
#{
issue
.
id
}
and title:
#{
issue
.
title
}
was not moved"
end
end
end
;
nil
end
;
nil
```
```
## Closing issues
1.
To exit the Rails console, enter
`quit`
.
When you decide that an issue is resolved, or no longer needed, you can close the issue.
## Close an issue
When you decide that an issue is resolved or no longer needed, you can close it.
The issue is marked as closed but is not deleted.
The issue is marked as closed but is not deleted.
To close an issue, you can do the following
:
Prerequisites
:
-
Select
**Close issue**
:
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
!
[
close issue - button
](
img/button_close_issue_v13_6.png
)
To close an issue, you can do the following:
-
At the top of the issue, select
**Close issue**
.
-
In an
[
issue board
](
../issue_board.md
)
, drag an issue card from its list into the
**Closed**
list.
-
In an
[
issue board
](
../issue_board.md
)
, drag an issue card from its list into the
**Closed**
list.
!
[
close issue from the issue board
](
img/close_issue_from_board.gif
)
!
[
close issue from the issue board
](
img/close_issue_from_board.gif
)
### Reopen a closed issue
### Reopen a closed issue
To reopen a closed issue, select
**Reopen issue**
.
Prerequisites:
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
To reopen a closed issue, at the top of the issue, select
**Reopen issue**
.
A reopened issue is no different from any other open issue.
A reopened issue is no different from any other open issue.
### Closing issues automatically
### Closing issues automatically
When a commit or merge request resolves issues, the issues
You can close issues automatically by using certain words in the commit message or MR description.
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
](
#default-closing-pattern
)
,
If a commit message or merge request description contains text matching the
[
defined pattern
](
#default-closing-pattern
)
,
all issues referenced in the matched text are closed. This happens when the commit
all issues referenced in the matched text are closed when either:
is pushed to a project's
[
**default** branch
](
../repository/branches/default.md
)
,
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
-
The commit is pushed to a project's
[
**default** branch
](
../repository/branches/default.md
)
.
description, issues
`#4`
and
`#6`
are closed automatically when the MR is merged, but not
`#5`
.
-
The commit or merge request is merged into the default branch.
Using
`Related to`
flags
`#5`
as a
[
related issue
](
related_issues.md
)
,
but is not closed automatically.
![
merge request closing issue when merged
](
img/merge_request_closes_issue_v13_11.png
)
For example, if you include
`Closes #4, #6, Related to #5`
in a merge request
description:
If the issue is in a different repository than the MR, add the full URL for the issue(s):
-
Issues
`#4`
and
`#6`
are closed automatically when the MR is merged.
-
Issue
`#5`
is marked as a
[
related issue
](
related_issues.md
)
, but it's not closed automatically.
```
markdown
Alternatively, when you
[
create a merge request from an issue
](
../merge_requests/getting_started.md#merge-requests-to-close-issues
)
,
Closes #4, #6, and https://gitlab.com/
<username>
/
<projectname>
/issues/
<xxx>
it inherits the issue's milestone and labels.
```
For performance reasons, automatic issue closing is disabled for the very first
For performance reasons, automatic issue closing is disabled for the very first
push from an existing repository.
push from an existing repository.
Alternatively, when you
[
create a merge request from an issue
](
../merge_requests/getting_started.md#merge-requests-to-close-issues
)
,
it inherits the issue's milestone and labels.
#### Default closing pattern
#### Default closing pattern
When not specified, this default issue closing pattern is used:
To automatically close an issue, use the following keywords followed by the issue reference.
```
shell
\b
((
?:[Cc]los
(
?:e[sd]?|ing
)
|
\b
[
Ff]ix
(
?:e[sd]|ing
)
?|
\b
[
Rr]esolv
(
?:e[sd]?|ing
)
|
\b
[
Ii]mplement
(
?:s|ed|ing
)
?
)(
:?
)
+
(
?:
(
?:issues? +
)
?%
{
issue_ref
}(
?:
(
?:
*
,? +and +|
*
,?
*
)
?
)
|
([
A-Z][A-Z0-9_]+-
\d
+
))
+
)
```
This translates to the following
keywords:
Available
keywords:
-
Close, Closes, Closed, Closing, close, closes, closed, closing
-
Close, Closes, Closed, Closing, close, closes, closed, closing
-
Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
-
Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
-
Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
-
Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
-
Implement, Implements, Implemented, Implementing, implement, implements, implemented, implementing
-
Implement, Implements, Implemented, Implementing, implement, implements, implemented, implementing
Note that
`%{issue_ref}`
is a complex regular expression defined inside the GitLab
Available issue reference formats:
source code that can match references to:
-
A local issue (
`#123`
).
-
A local issue (
`#123`
).
-
A cross-project issue (
`group/project#123`
).
-
A cross-project issue (
`group/project#123`
).
-
A link to
an issue (
`https://gitlab.example.com/group/project/issues/123`
).
-
The full URL of
an issue (
`https://gitlab.example.com/group/project/issues/123`
).
For example
the following commit message
:
For example:
```
plaintext
```
plaintext
Awesome commit message
Awesome commit message
...
@@ -397,47 +418,75 @@ This commit is also related to #17 and fixes #18, #19
...
@@ -397,47 +418,75 @@ This commit is also related to #17 and fixes #18, #19
and https://gitlab.example.com/group/otherproject/issues/23.
and https://gitlab.example.com/group/otherproject/issues/23.
```
```
closes
`#18`
,
`#19`
,
`#20`
, and
`#21`
in the project this commit is pushed to,
The previous commit message
closes
`#18`
,
`#19`
,
`#20`
, and
`#21`
in the project this commit is pushed to,
as well as
`#22`
and
`#23`
in
`group/otherproject`
.
`#17`
is not closed as it does
as well as
`#22`
and
`#23`
in
`group/otherproject`
.
`#17`
is not closed as it does
not match the pattern. It works with multi-line commit messages as well as one-liners
not match the pattern.
when used from the command line with
`git commit -m`
.
You can use the closing patterns in multi-line commit messages or one-liners
done from the command line with
`git commit -m`
.
The default issue closing pattern regex:
```
shell
\b
((
?:[Cc]los
(
?:e[sd]?|ing
)
|
\b
[
Ff]ix
(
?:e[sd]|ing
)
?|
\b
[
Rr]esolv
(
?:e[sd]?|ing
)
|
\b
[
Ii]mplement
(
?:s|ed|ing
)
?
)(
:?
)
+
(
?:
(
?:issues? +
)
?%
{
issue_ref
}(
?:
(
?:
*
,? +and +|
*
,?
*
)
?
)
|
([
A-Z][A-Z0-9_]+-
\d
+
))
+
)
```
#### Disabl
ing
automatic issue closing
#### Disabl
e
automatic issue closing
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/19754) in GitLab 12.7.
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/19754) in GitLab 12.7.
The automatic issue closing feature can be disabled on a per-project basis
You can disable the automatic issue closing feature on a per-project basis
in the
[
project's repository settings
](
../settings/index.md
)
. Referenced
in the
[
project's settings
](
../settings/index.md
)
.
issues are still displayed, but are not closed automatically.
![
disable issue auto close - settings
](
img/disable_issue_auto_close.png
)
Prerequisites:
-
You must have at least the
[
Maintainer role
](
../../permissions.md
)
for the project.
To disable automatic issue closing:
1.
On the top bar, select
**Menu > Projects**
and find your project.
1.
On the left sidebar, select
**Settings > Repository**
.
1.
Expand
**Default branch**
.
1.
Select
**Auto-close referenced issues on default branch**
.
1.
Select
**Save changes**
.
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
The automatic issue closing is
disabled by default
in a project if the project has the issue tracker
disabled. If you want to enable automatic issue closing, make sure to
disabled. If you want to enable automatic issue closing, make sure to
[
enable GitLab Issues
](
../settings/index.md#sharing-and-permissions
)
.
[
enable GitLab Issues
](
../settings/index.md#sharing-and-permissions
)
.
This only applies to issues affected by
new merge requests or commits. Already
Changing this setting applies only to
new merge requests or commits. Already
closed issues remain as
-is
.
closed issues remain as
they are
.
If issue tracking is enabled, disabling automatic issue closing only applies to merge requests
If issue tracking is enabled, disabling automatic issue closing only applies to merge requests
attempting to automatically close issues
with
in the same project.
attempting to automatically close issues in the same project.
Merge requests in other projects can still close another project's issues.
Merge requests in other projects can still close another project's issues.
#### Customiz
ing
the issue closing pattern **(FREE SELF)**
#### Customiz
e
the issue closing pattern **(FREE SELF)**
In order to change the default issue closing pattern, GitLab administrators must edit the
Prerequisites:
-
You must have the
[
administrator access level
](
../../../administration/index.md
)
for your GitLab instance.
To change the default issue closing pattern, edit the
[
`gitlab.rb` or `gitlab.yml` file
](
../../../administration/issue_closing_pattern.md
)
[
`gitlab.rb` or `gitlab.yml` file
](
../../../administration/issue_closing_pattern.md
)
of your installation.
of your installation.
## Change the issue type
## Change the issue type
Users with the
[
Developer role
](
../../permissions.md
)
Prerequisites:
can change an issue's type. To do this, edit the issue and select an issue type from the
**Issue type**
selector menu:
-
You must be the issue author or have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
To change issue type:
-
[
Issue
](
index.md
)
1.
To the right of the title, select
**Edit title and description**
(
**{pencil}**
).
-
[
Incident
](
../../../operations/incident_management/index.md
)
1.
Edit the issue and select an issue type from the
**Issue type**
dropdown list:
![
Change the issue type
](
img/issue_type_change_v13_12.png
)
-
Issue
-
[
Incident
](
../../../operations/incident_management/index.md
)
1.
Select
**Save changes**
.
## Delete an issue
## Delete an issue
...
@@ -463,16 +512,16 @@ Alternatively:
...
@@ -463,16 +512,16 @@ Alternatively:
> - Moved to GitLab Premium in 12.8.
> - Moved to GitLab Premium in 12.8.
> - Promoting issues to epics via the UI [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/233974) in GitLab Premium 13.6.
> - Promoting issues to epics via the UI [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/233974) in GitLab Premium 13.6.
You can promote an issue to an
epic
in the immediate parent group.
You can promote an issue to an
[
epic
](
../../group/epics/index.md
)
in the immediate parent group.
To promote an issue to an epic:
To promote an issue to an epic:
1.
In an issue, select the vertical ellipsis (
**{ellipsis_v}**
)
button
.
1.
In an issue, select the vertical ellipsis (
**{ellipsis_v}**
).
1.
Select
**Promote to epic**
.
1.
Select
**Promote to epic**
.
Alternatively, you can use the
`/promote`
[
quick action
](
../quick_actions.md#issues-merge-requests-and-epics
)
.
Alternatively, you can use the
`/promote`
[
quick action
](
../quick_actions.md#issues-merge-requests-and-epics
)
.
Read more about
promoting an issue to an epic on the
[
Manage epics page
](
../../group/epics/manage_epics.md#promote-an-issue-to-an-epic
)
.
Read more about
[
promoting an issues to epics
](
../../group/epics/manage_epics.md#promote-an-issue-to-an-epic
)
.
## Add an issue to an iteration **(PREMIUM)**
## Add an issue to an iteration **(PREMIUM)**
...
@@ -481,14 +530,12 @@ Read more about promoting an issue to an epic on the [Manage epics page](../../g
...
@@ -481,14 +530,12 @@ Read more about promoting an issue to an epic on the [Manage epics page](../../g
To add an issue to an
[
iteration
](
../../group/iterations/index.md
)
:
To add an issue to an
[
iteration
](
../../group/iterations/index.md
)
:
1.
Go to
your
issue.
1.
Go to
the
issue.
1.
On the right sidebar, in the
**Iteration**
section, select
**Edit**
.
1.
On the right sidebar, in the
**Iteration**
section, select
**Edit**
.
1.
From the dropdown list, select the iteration to associate this issue with.
1.
From the dropdown list, select the iteration to associate this issue with.
1.
Select any area outside the dropdown list.
1.
Select any area outside the dropdown list.
You can also use the
`/iteration`
Alternatively, you can use the
`/iteration`
[
quick action
](
../quick_actions.md#issues-merge-requests-and-epics
)
.
[
quick action
](
../quick_actions.md#issues-merge-requests-and-epics
)
in a comment or description field.
## Copy issue reference
## Copy issue reference
...
@@ -509,16 +556,16 @@ Read more about issue references in [GitLab-Flavored Markdown](../../markdown.md
...
@@ -509,16 +556,16 @@ Read more about issue references in [GitLab-Flavored Markdown](../../markdown.md
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/18816) in GitLab 13.8.
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/18816) in GitLab 13.8.
You can create a comment in an issue by sending an email.
You can create a comment in an issue by sending an email.
Sending an email to this address creates a comment that contains the email body.
To learn more about creating comments by sending an email and the necessary configuration, see
[
Reply to a comment by sending email
](
../../discussions/index.md#reply-to-a-comment-by-sending-email
)
.
To copy the issue's email address:
To copy the issue's email address:
1.
Go to the issue.
1.
Go to the issue.
1.
On the right sidebar, next to
**Issue email**
, select
**Copy Reference**
(
**{copy-to-clipboard}**
).
1.
On the right sidebar, next to
**Issue email**
, select
**Copy Reference**
(
**{copy-to-clipboard}**
).
Sending an email to this address creates a comment containing the email body.
To learn more about creating comments by sending an email and the necessary configuration, see
[
Reply to a comment by sending email
](
../../discussions/index.md#reply-to-a-comment-by-sending-email
)
.
## Real-time sidebar
## Real-time sidebar
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/17589) in GitLab 13.3. Disabled by default.
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/17589) in GitLab 13.3. Disabled by default.
...
@@ -552,37 +599,46 @@ To change the assignee on an issue:
...
@@ -552,37 +599,46 @@ To change the assignee on an issue:
## Similar issues
## Similar issues
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/22866) in GitLab 11.6.
To prevent duplication of issues on the same topic, GitLab searches for similar issues
when you create a new issue.
To prevent duplication of issues for the same topic, GitLab searches for similar issues
Prerequisites:
when new issues are being created.
As you type in the title field of the
**New Issue**
page, GitLab searches titles and descriptions
-
[
GraphQL
](
../../../api/graphql/index.md
)
must be enabled.
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
](
../../../api/graphql/index.md
)
must be enabled to use this feature.
![
Similar issues
](
img/similar_issues.png
)
As you type in the title text box of the
**New issue**
page, GitLab searches titles and descriptions
across all issues 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 text box.
## Health status **(ULTIMATE)**
## Health status **(ULTIMATE)**
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/36427) in GitLab
Ultimate
12.10.
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/36427) in GitLab 12.10.
> - Health status of closed issues [can't be edited](https://gitlab.com/gitlab-org/gitlab/-/issues/220867) in GitLab
Ultimate
13.4 and later.
> - Health status of closed issues [can't be edited](https://gitlab.com/gitlab-org/gitlab/-/issues/220867) in GitLab 13.4 and later.
> - Issue health status visible in issue lists [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/45141) in GitLab
Ultimate
13.6.
> - Issue health status visible in issue lists [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/45141) in GitLab 13.6.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/213567) in GitLab 13.7.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/213567) in GitLab 13.7.
To help you track issue statuses, you can assign a status to each issue.
To help you track issue statuses, you can assign a status to each issue.
This
marks issues as progressing as planned or needs attention to keep on schedule:
This
status marks issues as progressing as planned or needing attention to keep on schedule.
-
On track (green)
Prerequisites:
-
Needs attention (amber)
-
At risk (red)
-
You must have at least the
[
Reporter role
](
../../permissions.md
)
for the project.
To edit health status of an issue:
1.
Go to the issue.
1.
On the right sidebar, in the
**Health status**
section, select
**Edit**
.
1.
From the dropdown list, select the status to add to this issue:
-
On track (green)
-
Needs attention (amber)
-
At risk (red)
You can then see the issue's status in the issues list and the epic tree.
After an issue is closed, its health status can't be edited and the
**Edit**
button becomes disabled
After an issue is closed, its health status can't be edited and the
**Edit**
button becomes disabled
until the issue is reopened.
until the issue is reopened.
You can then see issue statuses in the issues list and the epic tree.
## Publish an issue **(ULTIMATE)**
## Publish an issue **(ULTIMATE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/30906) in GitLab 13.1.
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/30906) in GitLab 13.1.
...
@@ -591,3 +647,16 @@ If a status page application is associated with the project, you can use the `/p
...
@@ -591,3 +647,16 @@ If a status page application is associated with the project, you can use the `/p
[
quick action
](
../quick_actions.md
)
to publish the issue.
[
quick action
](
../quick_actions.md
)
to publish the issue.
For more information, see
[
GitLab Status Page
](
../../../operations/incident_management/status_page.md
)
.
For more information, see
[
GitLab Status Page
](
../../../operations/incident_management/status_page.md
)
.
## Issue-related quick actions
You can also use
[
quick actions
](
../quick_actions.md#issues-merge-requests-and-epics
)
to manage issues.
Some actions don't have corresponding UI buttons yet.
You can do the following
**only by using quick actions**
:
-
[
Add or remove a Zoom meeting
](
associate_zoom_meeting.md
)
(
`/zoom`
and
`/remove_zoom`
).
-
[
Publish an issue
](
#publish-an-issue
)
(
`/publish`
)
.
-
Clone an issue to the same or another project (
`/clone`
).
-
Close an issue and mark as a duplicate of another issue (
`/duplicate`
).
-
Copy labels and milestone from another merge request in the project (
`/copy_metadata`
).
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment