Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/gitlab-org/gitlab-foss.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGitLab Bot <gitlab-bot@gitlab.com>2020-08-20 21:42:06 +0300
committerGitLab Bot <gitlab-bot@gitlab.com>2020-08-20 21:42:06 +0300
commit6e4e1050d9dba2b7b2523fdd1768823ab85feef4 (patch)
tree78be5963ec075d80116a932011d695dd33910b4e /doc/user/group/custom_project_templates.md
parent1ce776de4ae122aba3f349c02c17cebeaa8ecf07 (diff)
Add latest changes from gitlab-org/gitlab@13-3-stable-ee
Diffstat (limited to 'doc/user/group/custom_project_templates.md')
-rw-r--r--doc/user/group/custom_project_templates.md45
1 files changed, 43 insertions, 2 deletions
diff --git a/doc/user/group/custom_project_templates.md b/doc/user/group/custom_project_templates.md
index ebeacda24c6..fd8d966fbe1 100644
--- a/doc/user/group/custom_project_templates.md
+++ b/doc/user/group/custom_project_templates.md
@@ -9,8 +9,49 @@ info: To determine the technical writer assigned to the Stage/Group associated w
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6861) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.6.
-When you create a new [project](../project/index.md), creating it based on custom project templates is
-a convenient option.
+Custom project templates are useful for organizations that need to create many similar types of [projects](../project/index.md) and want to start from the same jumping-off point.
+
+## Setting up Group-level Project Templates
+
+To use a custom project template for a new project you need to:
+
+1. [Create a 'templates' subgroup](subgroups/index.md).
+1. [Add repositories (projects) to the that new subgroup](index.md#add-projects-to-a-group), as your templates.
+1. Edit your group's settings to look to your 'templates' subgroup for templates:
+ 1. In the left-hand menu, click **{settings}** **Settings > General**.
+
+ NOTE: **Note:**
+ If you don't have access to the group's settings, you may not have sufficient privileges (for example, you may need developer or higher permissions).
+
+ 1. Scroll to **Custom project templates** and click **Expand**. If no **Custom project templates** section displays, make sure you've created a subgroup, and added a project (repository) to it.
+ 1. Select the 'templates' subgroup.
+
+### Example structure
+
+Here is a sample group/project structure for a hypothetical "Acme Co" for project templates:
+
+```txt
+# GitLab instance and group
+gitlab.com/acmeco/
+ # Subgroups
+ internal
+ tools
+ # Subgroup for handling project templates
+ websites
+ templates
+ # Project templates
+ client-site-django
+ client-site-gatsby
+ client-site-hTML
+
+ # Other projects
+ client-site-a
+ client-site-b
+ client-site-c
+ ...
+```
+
+### Adjust Settings
Users can configure a GitLab group that serves as template
source under a group's **Settings > General > Custom project templates**.