Commit 4cc0960c authored by Jonston Chan's avatar Jonston Chan Committed by Marcin Sedlak-Jakubowski

Docs: fix linting errors in doc/user/project/issues/issue_data_and_actions.md

parent c505e7ad
...@@ -10,14 +10,16 @@ Please read through the [GitLab Issue Documentation](index.md) for an overview o ...@@ -10,14 +10,16 @@ Please read through the [GitLab Issue Documentation](index.md) for an overview o
## Parts of an Issue ## Parts of an Issue
The image below illustrates what an issue may look like. Note that certain parts will The image below illustrates what an issue may look like. Certain parts
look slightly different or will be absent, depending on the version of GitLab being used look slightly different or are absent, depending on the GitLab version
and the permissions of the user viewing the issue. and the user's permissions.
You can find all the information for that issue on one screen. You can find all of an issue's information on one page.
![Issue view](img/issues_main_view_numbered.png) ![Issue view](img/issues_main_view_numbered.png)
The numbers in the image correspond to the following features:
- **1.** [Issue actions](#issue-actions) - **1.** [Issue actions](#issue-actions)
- **2.** [To Do](#to-do) - **2.** [To Do](#to-do)
- **3.** [Assignee](#assignee) - **3.** [Assignee](#assignee)
...@@ -47,10 +49,6 @@ You can find all the information for that issue on one screen. ...@@ -47,10 +49,6 @@ You can find all the information for that issue on one screen.
- **25.** [Submit comment, start a thread, or comment and close](#submit-comment-start-a-thread-or-comment-and-close) - **25.** [Submit comment, start a thread, or comment and close](#submit-comment-start-a-thread-or-comment-and-close)
- **26.** [Zoom meetings](#zoom-meetings) - **26.** [Zoom meetings](#zoom-meetings)
An issue starts with its status (open or closed), followed by its author,
and includes many other functionalities, numbered in the image above to
explain what they mean, one by one.
Many of the elements of the issue screen refresh automatically, such as the title and Many of the elements of the issue screen refresh automatically, such as the title and
description, when they are changed by another user. Comments and system notes also description, when they are changed by another user. Comments and system notes also
update automatically in response to various actions and content updates. update automatically in response to various actions and content updates.
...@@ -89,9 +87,9 @@ An issue can be assigned to: ...@@ -89,9 +87,9 @@ An issue can be assigned to:
- Another person. - Another person.
- [Many people](#multiple-assignees). **(STARTER)** - [Many people](#multiple-assignees). **(STARTER)**
The assignee(s) can be changed as often as needed. The idea is that the assignees are The assignees can be changed as often as needed. The idea is that the assignees are
responsible for that issue until it's reassigned to someone else to take it from there. responsible for that issue until it's reassigned to someone else to take it from there.
When assigned to someone, it will appear in their assigned issues list. When assigned to someone, it appears in their assigned issues list.
NOTE: NOTE:
If a user is not member of that project, it can only be If a user is not member of that project, it can only be
...@@ -99,7 +97,7 @@ assigned to them if they created the issue themselves. ...@@ -99,7 +97,7 @@ assigned to them if they created the issue themselves.
#### Multiple Assignees **(STARTER)** #### Multiple Assignees **(STARTER)**
Often multiple people work on the same issue together, which can be especially difficult Often, multiple people work on the same issue together. This can be difficult
to track in large teams where there is shared ownership of an issue. to track in large teams where there is shared ownership of an issue.
In [GitLab Starter](https://about.gitlab.com/pricing/), you can In [GitLab Starter](https://about.gitlab.com/pricing/), you can
...@@ -116,10 +114,10 @@ Select a [milestone](../milestones/index.md) to attribute that issue to. ...@@ -116,10 +114,10 @@ Select a [milestone](../milestones/index.md) to attribute that issue to.
### Time tracking ### Time tracking
Use [GitLab Quick Actions](../quick_actions.md) to [track estimates and time spent on issues](../time_tracking.md). Use [GitLab Quick Actions](../quick_actions.md) to [track estimates and time
You can add an [estimate of the time it will take](../time_tracking.md#estimates) spent on issues](../time_tracking.md). You can add a [time estimate](../time_tracking.md#estimates)
to resolve the issue, and also add [the time spent](../time_tracking.md#time-spent) for resolving the issue, and also add [the time spent](../time_tracking.md#time-spent)
on the resolution of the issue. to resolve the issue.
### Due date ### Due date
...@@ -132,13 +130,12 @@ element. Due dates can be changed as many times as needed. ...@@ -132,13 +130,12 @@ element. Due dates can be changed as many times as needed.
Categorize issues by giving them [labels](../labels.md). They help to organize workflows, Categorize issues by giving them [labels](../labels.md). They help to organize workflows,
and they enable you to work with the [GitLab Issue Board](index.md#issue-boards). and they enable you to work with the [GitLab Issue Board](index.md#issue-boards).
Group Labels, which allow you to use the same labels for all projects within the same Group Labels, which allow you to use the same labels for all projects in the same
group, can be also given to issues. They work exactly the same, but they are immediately group, can also be given to issues. They work exactly the same, but are immediately
available to all projects in the group. available to all projects in the group.
NOTE: If a label doesn't exist yet, you can create one by clicking **Edit**
If a label doesn't exist yet, you can click **Edit**, and it opens a dropdown menu followed by **Create new label** in the dropdown menu.
from which you can select **Create new label**.
### Weight **(STARTER)** ### Weight **(STARTER)**
...@@ -148,9 +145,8 @@ positive values or zero are allowed. ...@@ -148,9 +145,8 @@ positive values or zero are allowed.
### Confidentiality ### Confidentiality
You can [set an issue to be confidential](confidential_issues.md). When set, unauthorized You can [set an issue to be confidential](confidential_issues.md). Unauthorized users
users will not be able to access the issue, and will not see it listed in project cannot access the issue, and it is not listed in the project's issue boards nor list for them.
issue boards or the issue list.
### Lock issue ### Lock issue
...@@ -165,7 +161,7 @@ or were mentioned in the description or threads. ...@@ -165,7 +161,7 @@ or were mentioned in the description or threads.
### Notifications ### Notifications
Click on the icon to enable/disable [notifications](../../profile/notifications.md#issue--epics--merge-request-events) Click on the icon to enable/disable [notifications](../../profile/notifications.md#issue--epics--merge-request-events)
for the issue. This will automatically enable if you participate in the issue in any way. for the issue. Notifications are automatically enabled after you participate in the issue in any way.
- **Enable**: If you are not a participant in the discussion on that issue, but - **Enable**: If you are not a participant in the discussion on that issue, but
want to receive notifications on each update, subscribe to it. want to receive notifications on each update, subscribe to it.
...@@ -180,9 +176,9 @@ for the issue. This will automatically enable if you participate in the issue in ...@@ -180,9 +176,9 @@ for the issue. This will automatically enable if you participate in the issue in
### Edit ### Edit
Clicking this icon opens the issue for editing, and you will have access to all the Clicking this icon opens the issue for editing. All the fields which
same fields as when the issue was created. This icon will not display if the user were shown when the issue was created are displayed for editing.
does not have permission to edit the issue. This icon is only displayed if the user has permission to edit the issue.
### Description ### Description
...@@ -195,17 +191,15 @@ allowing many formatting options. ...@@ -195,17 +191,15 @@ allowing many formatting options.
### Mentions ### Mentions
You can mention a user or a group present in your GitLab instance with `@username` or You can mention a user or a group present in your GitLab instance with `@username` or
`@groupname` and they will be notified via to-dos and email, unless they have disabled `@groupname`. All mentioned users are notified via to-do items and emails,
all notifications in their profile settings. This is controlled in the unless they have disabled all notifications in their profile settings.
[notification settings](../../profile/notifications.md). This is controlled in the [notification settings](../../profile/notifications.md).
Mentions for yourself (the current logged in user), will be highlighted in a different Mentions for yourself (the current logged in user) are highlighted
color, allowing you to easily see which comments involve you, helping you focus on in a different color, which allows you to quickly see which comments involve you.
them quickly.
NOTE:
Avoid mentioning `@all` in issues and merge requests, as it sends an email notification Avoid mentioning `@all` in issues and merge requests, as it sends an email notification
to all the members of that project's group, which can be interpreted as spam. to all the members of that project's group. This might be interpreted as spam.
### Related Issues ### Related Issues
...@@ -217,18 +211,18 @@ You can also click the `+` to add more related issues. ...@@ -217,18 +211,18 @@ You can also click the `+` to add more related issues.
Merge requests that were mentioned in that issue's description or in the issue thread Merge requests that were mentioned in that issue's description or in the issue thread
are listed as [related merge requests](crosslinking_issues.md#from-merge-requests) here. are listed as [related merge requests](crosslinking_issues.md#from-merge-requests) here.
Also, if the current issue was mentioned as related in another merge request, that Also, if the current issue was mentioned as related in another merge request, that
merge request will be listed here. merge request is also listed here.
### Award emoji ### Award emoji
You can award an emoji to that issue. There are shortcuts to "thumbs_up" and "thumbs_down", You can award emojis to issues. You can select the "thumbs up" and "thumbs down",
or you can click on the light gray "face" to choose a different reaction from the or the gray "smiley-face" to choose from the list of available
dropdown list of available [GitLab Flavored Markdown Emoji](../../markdown.md#emoji). [GitLab Flavored Markdown Emoji](../../markdown.md#emoji).
NOTE: NOTE:
Posting "+1" as a comment in a thread spams all subscribed participants of that issue, Posting "+1" as a comment in a thread spams all subscribed participants of that issue,
clutters the threads, and is not recommended. Awarding an emoji is a way clutters the threads, and is not recommended. Awarding an emoji is a way
to let them know your reaction without spamming them. to let them know your reaction without notifying them.
### Show all activity ### Show all activity
...@@ -241,21 +235,20 @@ and selecting either: ...@@ -241,21 +235,20 @@ and selecting either:
Also: Also:
- You can mention a user or a group present in your GitLab instance with - You can mention a user or a group present in your GitLab instance with
`@username` or `@groupname` and they will be notified via to-do items `@username` or `@groupname` and they are notified via to-do items
and email, unless they have [disabled all notifications](#notifications) and emails, unless they have [disabled all notifications](#notifications)
in their profile settings. in their profile settings.
- Mentions for yourself (the current logged in user), will be highlighted - Mentions for yourself (the current logged-in user) are highlighted
in a different color, allowing you to easily see which comments involve you, in a different color, which allows you to quickly see which comments involve you.
helping you focus on them quickly.
![Show all activity](img/show-all-activity.png) ![Show all activity](img/show-all-activity.png)
### Create Merge Request ### Create Merge Request
Create a new branch and [**Draft** merge request](../merge_requests/work_in_progress_merge_requests.md) Create a new branch and [**Draft** merge request](../merge_requests/work_in_progress_merge_requests.md)
in one action. The branch will be named `issuenumber-title` by default, but you can in one action. The branch is named `issuenumber-title` by default, but you can
choose any name, and GitLab will verify that it is not already in use. The merge request choose any name, and GitLab verifies that it is not already in use. The merge request
will automatically inherit the milestone and labels of the issue, and will be set to inherits the milestone and labels of the issue, and is set to automatically
close the issue when it is merged. close the issue when it is merged.
![Create MR from issue](img/create_mr_from_issue.png) ![Create MR from issue](img/create_mr_from_issue.png)
...@@ -288,11 +281,11 @@ supports [GitLab Flavored Markdown](../../markdown.md#gitlab-flavored-markdown-g ...@@ -288,11 +281,11 @@ supports [GitLab Flavored Markdown](../../markdown.md#gitlab-flavored-markdown-g
### Submit comment, start a thread, or comment and close ### Submit comment, start a thread, or comment and close
Once you write a comment, you can: After you write a comment, you can:
- Click **Comment** and your comment will be published. - Click **Comment** and to publish your comment.
- Choose **Start thread** from the dropdown list and start a new [thread](../../discussions/index.md#threaded-discussions) - Choose **Start thread** from the dropdown list and start a new [thread](../../discussions/index.md#threaded-discussions)
within that issue's main thread to discuss specific points. This invites other participants in that issue's main thread to discuss specific points. This invites other participants
to reply directly to your thread, keeping related comments grouped together. to reply directly to your thread, keeping related comments grouped together.
![Comment or thread](img/comment-or-discussion.png) ![Comment or thread](img/comment-or-discussion.png)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment