Commit b9c108f2 authored by Alexandru Croitor's avatar Alexandru Croitor

Enable group level description templates by default

Turning the inherited_issuable_templates FF to enabled by default
parent 189bf0ed
---
title: Configure issue and merge request description templates at group level and rolldown description templates in the group hierarchy
merge_request: 56737
author:
type: added
...@@ -5,4 +5,4 @@ rollout_issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/321247 ...@@ -5,4 +5,4 @@ rollout_issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/321247
milestone: '13.9' milestone: '13.9'
type: development type: development
group: group::project management group: group::project management
default_enabled: false default_enabled: true
...@@ -89,32 +89,27 @@ For example: `https://gitlab.com/gitlab-org/gitlab/-/issues/new?issuable_templat ...@@ -89,32 +89,27 @@ For example: `https://gitlab.com/gitlab-org/gitlab/-/issues/new?issuable_templat
![Description templates](img/description_templates.png) ![Description templates](img/description_templates.png)
### Set an issue and merge request description template at group level **(PREMIUM)** You can set description templates at various levels:
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/52360) in GitLab 13.9. - The entire [instance](#set-instance-level-description-templates)
> - It's [deployed behind a feature flag](../feature_flags.md), disabled by default. - A specific [group or subgroup](#set-group-level-description-templates)
> - It's disabled by default on GitLab.com. - A specific [project](#set-a-default-template-for-merge-requests-and-issues)
> - To use it in GitLab self-managed instances, ask a GitLab administrator to
[enable it](#enable-or-disable-issue-and-merge-request-description-templates-at-group-and-instance-level).
Templates can be useful because you can create a template once and use it multiple times.
To re-use templates [you've created](../project/description_templates.md#create-an-issue-template):
1. Go to the group's **Settings > General > Templates**.
1. From the dropdown, select your template project as the template repository at group level.
![Group template settings](../group/img/group_file_template_settings.png) The templates are inherited. For example, in a project, you can also access templates set for the
instance or the project's parent groups.
### Set an issue and merge request description template at instance level **(PREMIUM ONLY)** ### Set instance-level description templates **(PREMIUM SELF)**
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/52360) in GitLab 13.9. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/52360) in GitLab 13.9.
> - It's [deployed behind a feature flag](../feature_flags.md), disabled by default. > - It's [deployed behind a feature flag](../feature_flags.md), disabled by default.
> - It's disabled by default on GitLab.com. > - [Became enabled by default](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/56737) in GitLab 13.11.
> - To use it in GitLab self-managed instances, ask a GitLab administrator to > - It's enabled by default on GitLab.com.
[enable it](#enable-or-disable-issue-and-merge-request-description-templates-at-group-and-instance-level). > - For GitLab self-managed instances, GitLab administrators can opt to [disable it](#enable-or-disable-issue-and-merge-request-description-templates-at-group-and-instance-level). **(PREMIUM SELF)**
You can set a description template at the **instance level** for issues
and merge requests.
As a result, these templates are available in all projects within the instance.
Similar to group templates, issue and merge request templates can also be set up at the instance level.
This results in those templates being available in all projects within the instance.
Only instance administrators can set instance-level templates. Only instance administrators can set instance-level templates.
To set the instance-level description template repository: To set the instance-level description template repository:
...@@ -122,15 +117,41 @@ To set the instance-level description template repository: ...@@ -122,15 +117,41 @@ To set the instance-level description template repository:
1. Select the **Admin Area** icon (**{admin}**). 1. Select the **Admin Area** icon (**{admin}**).
1. Go to **Settings > Templates**. 1. Go to **Settings > Templates**.
1. From the dropdown, select your template project as the template repository at instance level. 1. From the dropdown, select your template project as the template repository at instance level.
1. Select **Save changes**.
![Setting templates in the Admin Area](../admin_area/settings/img/file_template_admin_area.png)
Learn more about [instance template repository](../admin_area/settings/instance_template_repository.md). Learn more about [instance template repository](../admin_area/settings/instance_template_repository.md).
![Setting templates in the Admin Area](../admin_area/settings/img/file_template_admin_area.png) ### Set group-level description templates **(PREMIUM)**
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/52360) in GitLab 13.9.
> - It's [deployed behind a feature flag](../feature_flags.md), disabled by default.
> - [Became enabled by default](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/56737) in GitLab 13.11.
> - It's enabled by default on GitLab.com.
> - For GitLab self-managed instances, GitLab administrators can opt to [disable it](#enable-or-disable-issue-and-merge-request-description-templates-at-group-and-instance-level). **(PREMIUM SELF)**
With **group-level** description templates, you can store your templates in a single repository and
configure the group file templates setting to point to that repository.
As a result, you can use the same templates in issues and merge requests in all the group's projects.
To re-use templates [you've created](../project/description_templates.md#create-an-issue-template):
1. Go to the group's **Settings > General > Templates**.
1. From the dropdown, select your template project as the template repository at group level.
1. Select **Save changes**.
![Group template settings](../group/img/group_file_template_settings.png)
### Set a default template for merge requests and issues **(PREMIUM)** ### Set a default template for merge requests and issues **(PREMIUM)**
In a project, you can choose a default description template for new issues and merge requests.
As a result, every time a new merge request or issue is created, it's pre-filled with the text you
entered in the template.
The visibility of issues or merge requests should be set to either "Everyone The visibility of issues 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 don't show. This is the default behavior, so in most cases template text areas don't show. This is the default behavior, so in most cases
you should be fine. you should be fine.
...@@ -149,9 +170,6 @@ To set a default description template for issues: ...@@ -149,9 +170,6 @@ To set a default description template for issues:
Because GitLab merge request and issues support [Markdown](../markdown.md), you can use it to format Because GitLab merge request and issues support [Markdown](../markdown.md), you can use it to format
headings, lists, and so on. headings, lists, and so on.
Now, every time a new merge request or issue is created, it's pre-filled with the text you entered
in the templates.
[GitLab versions 13.10 and later](https://gitlab.com/gitlab-org/gitlab/-/issues/885) [GitLab versions 13.10 and later](https://gitlab.com/gitlab-org/gitlab/-/issues/885)
provide `issues_template` and `merge_requests_template` attributes in the provide `issues_template` and `merge_requests_template` attributes in the
[Projects API](../../api/projects.md) to help you keep your templates up to date. [Projects API](../../api/projects.md) to help you keep your templates up to date.
...@@ -211,9 +229,9 @@ it's very hard to read otherwise.) ...@@ -211,9 +229,9 @@ it's very hard to read otherwise.)
Setting issue and merge request description templates at group and instance levels Setting issue and merge request description templates at group and instance levels
is under development and not ready for production use. It is deployed behind a is under development and not ready for production use. It is deployed behind a
feature flag that is **disabled by default**. feature flag that is **enabled by default**.
[GitLab administrators with access to the GitLab Rails console](../../administration/feature_flags.md) [GitLab administrators with access to the GitLab Rails console](../../administration/feature_flags.md)
can enable it. can disable it.
To enable it: To enable it:
......
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