-[Extra Sidekiq operations](extra_sidekiq_processes.md): Configure an extra set of Sidekiq processes to ensure certain queues always have dedicated workers, no matter the amount of jobs that need to be processed. **(STARTER ONLY)**
-[Multiple Sidekiq processes](extra_sidekiq_processes.md): Configure multiple Sidekiq processes to ensure certain queues always have dedicated workers, no matter the number of jobs that need to be processed. **(CORE ONLY)**
-[Unicorn](unicorn.md): Understand Unicorn and unicorn-worker-killer.
-[Unicorn](unicorn.md): Understand Unicorn and unicorn-worker-killer.
- Speed up SSH operations by [Authorizing SSH users via a fast,
- Speed up SSH operations by [Authorizing SSH users via a fast,
indexed lookup to the GitLab database](fast_ssh_key_lookup.md), and/or
indexed lookup to the GitLab database](fast_ssh_key_lookup.md), and/or
@@ -15,14 +15,14 @@ There are standard comments, and you also have the option to create a comment
...
@@ -15,14 +15,14 @@ There are standard comments, and you also have the option to create a comment
in the form of a thread. A comment can also be [turned into a thread](#start-a-thread-by-replying-to-a-standard-comment)
in the form of a thread. A comment can also be [turned into a thread](#start-a-thread-by-replying-to-a-standard-comment)
when it receives a reply.
when it receives a reply.
The comment area supports [Markdown] and [quick actions]. You can edit your own
The comment area supports [Markdown](../markdown.md) and [quick actions](../project/quick_actions.md). You can edit your own
comment at any time, and anyone with [Maintainer access level][permissions] or
comment at any time, and anyone with [Maintainer access level](../permissions.md) or
higher can also edit a comment made by someone else.
higher can also edit a comment made by someone else.
You can also reply to a comment notification email to reply to the comment if
You can also reply to a comment notification email to reply to the comment if
[Reply by email] is configured for your GitLab instance. Replying to a standard comment
[Reply by email] is configured for your GitLab instance. Replying to a standard comment
creates another standard comment. Replying to a threaded comment creates a reply in the thread. Email replies support
creates another standard comment. Replying to a threaded comment creates a reply in the thread. Email replies support
[Markdown] and [quick actions], just as if you replied from the web.
[Markdown](../markdown.md) and [quick actions](../project/quick_actions.md), just as if you replied from the web.
NOTE: **Note:**
NOTE: **Note:**
There is a limit of 5,000 comments for every object, for example: issue, epic, and merge request.
There is a limit of 5,000 comments for every object, for example: issue, epic, and merge request.
...
@@ -48,7 +48,7 @@ to address feedback and lets you hide threads that are no longer relevant.
...
@@ -48,7 +48,7 @@ to address feedback and lets you hide threads that are no longer relevant.
### Commit threads in the context of a merge request
### Commit threads in the context of a merge request
> [Introduced][ce-31847] in GitLab 10.3.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/31847) in GitLab 10.3.
For reviewers with commit-based workflow, it may be useful to add threads to
For reviewers with commit-based workflow, it may be useful to add threads to
specific commit diffs in the context of a merge request. These threads will
specific commit diffs in the context of a merge request. These threads will
...
@@ -112,7 +112,7 @@ Alternatively, you can mark each comment as resolved individually.
...
@@ -112,7 +112,7 @@ Alternatively, you can mark each comment as resolved individually.
### Move all unresolved threads in a merge request to an issue
### Move all unresolved threads in a merge request to an issue
> [Introduced][ce-8266] in GitLab 9.1
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/8266) in GitLab 9.1
To continue all open threads from a merge request in a new issue, click the
To continue all open threads from a merge request in a new issue, click the
**Resolve all threads in new issue** button.
**Resolve all threads in new issue** button.
...
@@ -156,7 +156,7 @@ add a note to the merge request thread referencing the new issue.
...
@@ -156,7 +156,7 @@ add a note to the merge request thread referencing the new issue.
### Only allow merge requests to be merged if all threads are resolved
### Only allow merge requests to be merged if all threads are resolved
> [Introduced][ce-7125] in GitLab 8.14.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/7125) in GitLab 8.14.
You can prevent merge requests from being merged until all threads are
You can prevent merge requests from being merged until all threads are
resolved.
resolved.
...
@@ -174,7 +174,7 @@ are resolved.
...
@@ -174,7 +174,7 @@ are resolved.
### Automatically resolve merge request diff threads when they become outdated
### Automatically resolve merge request diff threads when they become outdated
> [Introduced][ce-14053] in GitLab 10.0.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/14053) in GitLab 10.0.
You can automatically resolve merge request diff threads on lines modified
You can automatically resolve merge request diff threads on lines modified
with a new push.
with a new push.
...
@@ -200,7 +200,7 @@ force push.
...
@@ -200,7 +200,7 @@ force push.
## Threaded discussions
## Threaded discussions
> [Introduced][ce-7527] in GitLab 9.1.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/7527) in GitLab 9.1.
While resolvable threads are only available to merge request diffs,
While resolvable threads are only available to merge request diffs,
threads can also be added without a diff. You can start a specific
threads can also be added without a diff. You can start a specific
...
@@ -220,7 +220,7 @@ comments in greater detail.
...
@@ -220,7 +220,7 @@ comments in greater detail.
## Image threads
## Image threads
> [Introduced][ce-14061] in GitLab 10.1.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/14061) in GitLab 10.1.
Sometimes a thread is revolved around an image. With image threads,
Sometimes a thread is revolved around an image. With image threads,
you can easily target a specific coordinate of an image and start a thread
you can easily target a specific coordinate of an image and start a thread
...
@@ -257,7 +257,7 @@ load and will have a corresponding badge counter to match the counter on the ima
...
@@ -257,7 +257,7 @@ load and will have a corresponding badge counter to match the counter on the ima
## Lock discussions
## Lock discussions
> [Introduced][ce-14531] in GitLab 10.1.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/14531) in GitLab 10.1.
For large projects with many contributors, it may be useful to stop threads
For large projects with many contributors, it may be useful to stop threads
in issues or merge requests in these scenarios:
in issues or merge requests in these scenarios:
...
@@ -313,7 +313,7 @@ All comments that are part of a review show two buttons:
...
@@ -313,7 +313,7 @@ All comments that are part of a review show two buttons:
![A comment that is part of a review](img/pending_review_comment.png)
![A comment that is part of a review](img/pending_review_comment.png)
You can use [quick actions] inside review comments. The comment will show the actions that will be performed once published.
You can use [quick actions](../project/quick_actions.md) inside review comments. The comment will show the actions that will be performed once published.
![A review comment with quick actions](img/review_comment_quickactions.png)
![A review comment with quick actions](img/review_comment_quickactions.png)
...
@@ -500,20 +500,3 @@ to the original comment, so a note about when it was last edited will appear und
...
@@ -500,20 +500,3 @@ to the original comment, so a note about when it was last edited will appear und
This feature only exists for Issues, Merge requests, and Epics. Commits, Snippets and Merge request diff threads are
This feature only exists for Issues, Merge requests, and Epics. Commits, Snippets and Merge request diff threads are
>[Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/4981) in GitLab 8.11.
We all know that a properly submitted issue is more likely to be addressed in
We all know that a properly submitted issue is more likely to be addressed in
a timely manner by the developers of a project.
a timely manner by the developers of a project.
...
@@ -27,12 +27,12 @@ templates of the default branch will be taken into account.
...
@@ -27,12 +27,12 @@ templates of the default branch will be taken into account.
- Add a template to be used in every issue for a specific project,
- Add a template to be used in every issue for a specific project,
giving instructions and guidelines, requiring for information specific to that subject.
giving instructions and guidelines, requiring for information specific to that subject.
For example, if you have a project for tracking new blog posts, you can require the
For example, if you have a project for tracking new blog posts, you can require the
title, outlines, author name, author social media information, etc.
title, outlines, author name, author social media information, and so on.
- Following the previous example, you can make a template for every MR submitted
- Following the previous example, you can make a template for every MR submitted
with a new blog post, requiring information about the post date, frontmatter data,
with a new blog post, requiring information about the post date, frontmatter data,
images guidelines, link to the related issue, reviewer name, etc.
images guidelines, link to the related issue, reviewer name, and so on.
- You can also create issues and merge request templates for different
- You can also create issues and merge request templates for different
stages of your workflow, e.g., feature proposal, feature improvement, bug report, etc.
stages of your workflow, for example, feature proposal, feature improvement, or a bug report.
## Creating issue templates
## Creating issue templates
...
@@ -57,25 +57,25 @@ changes you made after picking the template and return it to its initial status.
...
@@ -57,25 +57,25 @@ changes you made after picking the template and return it to its initial status.
## Setting a default template for merge requests and issues **(STARTER)**
## Setting a default template for merge requests and issues **(STARTER)**
> **Notes:**
> - This feature was introduced before [description templates](#overview) and is available in [GitLab Starter](https://about.gitlab.com/pricing/). It can be enabled in the project's settings.
>
> - Templates for issues were [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/28) in GitLab EE 8.1.
> - This feature was introduced before [description templates](#overview) and is
> - Templates for merge requests were [introduced](https://gitlab.com/gitlab-org/gitlab/commit/7478ece8b48e80782b5465b96c79f85cc91d391b) in GitLab EE 6.9.
> available in [GitLab Starter][products]. It can be enabled
> in the project's settings.
> - Templates for issues were [introduced][ee-28] in GitLab EE 8.1.
> - Templates for merge requests were [introduced][ee-7478ece] in GitLab EE 6.9.
The visibility of issues and/or merge requests should be set to either "Everyone
The visibility of issues and/or merge requests should be set to either "Everyone
with access" or "Only Project Members" in your project's **Settings / Visibility, project features, permissions** section, otherwise the
with access" or "Only Project Members" in your project's **Settings / Visibility, project features, permissions** section, otherwise the
template text areas won't show. This is the default behavior so in most cases
template text areas won't show. This is the default behavior so in most cases
you should be fine.
you should be fine.
Go to your project's **Settings** and under the **Merge requests** header, click *Expand* and fill in the "Default description template
1. Go to your project's **Settings**.
for merge requests" text area. Under the **Default issue template**, click *Expand* and fill in "Default description template for issues" text area. Since GitLab merge request and issues
1. Click **Expand** under the **Merge requests** header.
support [Markdown](../markdown.md), you can use special markup like
1. Fill in the **Default description template for merge requests** text area.
headings, lists, etc.
1. Click **Expand** under **Default issue template**.
1. Fill in the **Default description template for issues** text area.
Since GitLab merge request and issues support [Markdown](../markdown.md), you can use it to format
After you add the description, hit **Save changes** for the settings to take
After you add the description, hit **Save changes** for the settings to take
...
@@ -84,12 +84,16 @@ pre-filled with the text you entered in the template(s).
...
@@ -84,12 +84,16 @@ pre-filled with the text you entered in the template(s).
## Description template example
## Description template example
We make use of Description Templates for Issues and Merge Requests within the GitLab Community Edition project. Please refer to the [`.gitlab` folder][gitlab-templates] for some examples.
We make use of Description Templates for Issues and Merge Requests within the GitLab Community
Edition project. Please refer to the [`.gitlab` folder](https://gitlab.com/gitlab-org/gitlab/tree/master/.gitlab)
for some examples.
> **Tip:**
TIP: **Tip:**
It is possible to use [quick actions](quick_actions.md) within description templates to quickly add labels, assignees, and milestones. The quick actions will only be executed if the user submitting the Issue or Merge Request has the permissions to perform the relevant actions.
It's possible to use [quick actions](quick_actions.md) within description templates to quickly add
labels, assignees, and milestones. The quick actions will only be executed if the user submitting
the issue or merge request has the permissions to perform the relevant actions.
> [Introduced][ce-5554] in [GitLab 8.11](https://about.gitlab.com/releases/2016/08/22/gitlab-8-11-released/#issue-board).
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/5554) in [GitLab 8.11](https://about.gitlab.com/releases/2016/08/22/gitlab-8-11-released/#issue-board).
## Overview
## Overview
The GitLab Issue Board is a software project management tool used to plan,
The GitLab Issue Board is a software project management tool used to plan,
organize, and visualize a workflow for a feature or product release.
organize, and visualize a workflow for a feature or product release.
It can be used as a [Kanban] or a [Scrum] board.
It can be used as a [Kanban](https://en.wikipedia.org/wiki/Kanban_(development)) or a
You can define the scope of your board when creating it or by clicking on the "Edit board" button. Once a milestone, assignee or weight is assigned to an Issue Board, you will no longer be able to filter
You can define the scope of your board when creating it or by clicking on the "Edit board" button.
through these in the search bar. In order to do that, you need to remove the desired scope (e.g. milestone, assignee or weight) from the Issue Board.
Once a milestone, assignee or weight is assigned to an Issue Board, you will no longer be able to
filter through these in the search bar. In order to do that, you need to remove the desired scope
(for example, milestone, assignee, or weight) from the Issue Board.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/2817) in GitLab 8.5.
When you log into GitLab, you normally want to see where you should spend your
When you log into GitLab, you normally want to see where you should spend your
time, take some action, or know what you need to keep an eye on without
time, take some action, or know what you need to keep an eye on without
...
@@ -29,7 +29,7 @@ displays on the To-Do List.
...
@@ -29,7 +29,7 @@ displays on the To-Do List.
## What triggers a To Do
## What triggers a To Do
A To Do displays on your To-Do List when:
A To Do appears on your To-Do List when:
- An issue or merge request is assigned to you
- An issue or merge request is assigned to you
- You are `@mentioned` in the description or comment of an:
- You are `@mentioned` in the description or comment of an:
...
@@ -46,11 +46,13 @@ A To Do displays on your To-Do List when:
...
@@ -46,11 +46,13 @@ A To Do displays on your To-Do List when:
To-do triggers are not affected by [GitLab Notification Email settings](profile/notifications.md).
To-do triggers are not affected by [GitLab Notification Email settings](profile/notifications.md).
NOTE: **Note:**
NOTE: **Note:**
When a user no longer has access to a resource related to a To Do (like an issue, merge request, project, or group) the related To-Do items are deleted within the next hour for security reasons. The delete is delayed to prevent data loss, in case the user's access was revoked by mistake.
When a user no longer has access to a resource related to a To Do (like an issue, merge request,
project, or group) the related To-Do items are deleted within the next hour for security reasons.
The delete is delayed to prevent data loss, in case the user's access was revoked by mistake.
### Directly addressing a To Do
### Directly addressing a To Do
> [Introduced][ce-7926] in GitLab 9.0.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/7926) in GitLab 9.0.
If you are mentioned at the start of a line, the To Do you receive will be listed
If you are mentioned at the start of a line, the To Do you receive will be listed
as 'directly addressed'. For example, in this comment:
as 'directly addressed'. For example, in this comment:
...
@@ -136,7 +138,12 @@ There are four kinds of filters you can use on your To-Do List.
...
@@ -136,7 +138,12 @@ There are four kinds of filters you can use on your To-Do List.
| Type | Filter by issue, merge request, or epic **(ULTIMATE)** |
| Type | Filter by issue, merge request, or epic **(ULTIMATE)** |
| Action | Filter by the action that triggered the To Do |
| Action | Filter by the action that triggered the To Do |
You can also filter by more than one of these at the same time. The possible Actions are `Any Action`, `Assigned`, `Mentioned`, `Added`, `Pipelines`, and `Directly Addressed`, [as described above](#what-triggers-a-to-do).
You can also filter by more than one of these at the same time. The possible Actions are
[described above](#what-triggers-a-to-do) and include:
it'pushes to a project using a specific Praefect repository storage',:smoke,:requires_admin,:requires_praefect,quarantine: {issue: 'https://gitlab.com/gitlab-org/quality/testcases/-/issues/276',type: :new}do
it'pushes to a project using a specific Praefect repository storage',:smoke,:requires_admin,:requires_praefectdo