From a0988f73659d9a6686167792b6272cf5440bdbcf Mon Sep 17 00:00:00 2001 From: Dennis Tang <750946-dennis@users.noreply.gitlab.com> Date: Thu, 29 Nov 2018 10:14:49 +0000 Subject: Link group/index.md to group-level project templates page --- doc/user/group/index.md | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'doc') diff --git a/doc/user/group/index.md b/doc/user/group/index.md index d673fa4d21a..30680ab87d7 100644 --- a/doc/user/group/index.md +++ b/doc/user/group/index.md @@ -259,6 +259,11 @@ types with every project in a group. Learn more about [Group-level file templates](https://docs.gitlab.com/ee/user/group/index.html#group-level-file-templates-premium). +#### Group-level project templates **[PREMIUM]** + +Define project templates at a group-level by setting a group as a template source. +[Learn more about group-level project templates.](custom_project_templates.md) + ### Advanced settings - **Projects**: view all projects within that group, add members to each project, -- cgit v1.2.3 From b0998fc6b0124f46671f558e315fa6f049b3ba43 Mon Sep 17 00:00:00 2001 From: Dennis Tang <750946-dennis@users.noreply.gitlab.com> Date: Fri, 30 Nov 2018 12:48:16 +0000 Subject: Add docs for custom project templates --- doc/user/admin_area/custom_project_templates.md | 25 +++++++++++++++++++++++++ doc/user/group/custom_project_templates.md | 23 +++++++++++++++++++++++ 2 files changed, 48 insertions(+) create mode 100644 doc/user/admin_area/custom_project_templates.md create mode 100644 doc/user/group/custom_project_templates.md (limited to 'doc') diff --git a/doc/user/admin_area/custom_project_templates.md b/doc/user/admin_area/custom_project_templates.md new file mode 100644 index 00000000000..5afbf9f2934 --- /dev/null +++ b/doc/user/admin_area/custom_project_templates.md @@ -0,0 +1,25 @@ +# Custom instance-level project templates **[PREMIUM ONLY]** + +> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing) 11.2. + +When you create a new project, creating it based on custom project templates is +a convenient option to bootstrap from an existing project boilerplate. +The administration setting to configure a GitLab group that serves as template +source can be found under **Admin > Settings > Custom project templates**. + +Within this section, you can configure the group where all the custom project +templates are sourced. Every project directly under the group namespace will be +available to the user if they have access to them. For example, every public +project in the group will be available to every logged user. However, +private projects will be available only if the user has view [permissions](../permissions.md) +in the project: + +- Project Owner, Maintainer, Developer, Reporter or Guest +- Is a member of the Group: Owner, Maintainer, Developer, Reporter or Guest + +Projects below subgroups of the template group are **not** supported. + +Repository and database information that are copied over to each new project are +identical to the data exported with [GitLab's Project Import/Export](../project/settings/import_export.md). + +If you would like to set project templates at a group level, please see [Custom group-level project templates](../group/custom_project_templates.md). \ No newline at end of file diff --git a/doc/user/group/custom_project_templates.md b/doc/user/group/custom_project_templates.md new file mode 100644 index 00000000000..0be9ea8226f --- /dev/null +++ b/doc/user/group/custom_project_templates.md @@ -0,0 +1,23 @@ +# Custom group-level project templates **[PREMIUM ONLY]** + +> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6861) in [GitLab Premium](https://about.gitlab.com/pricing) 11.6. + +When you create a new project, creating it based on custom project templates is +a convenient option to bootstrap from an existing project boilerplate. +The group-level setting to configure a GitLab group that serves as template +source can be found under **Group > Settings > General > Custom project templates**. + +Within this section, you can configure the group where all the custom project +templates are sourced. Every project directly under the group namespace will be +available to the user if they have access to them. For example, every public +project in the group will be available to every logged in user. However, +private projects will be available only if the user has view [permissions](../permissions.md) +in the project. That is, users with Owner, Maintainer, Developer, Reporter or Guest roles for projects, +or for groups to which the project belongs. + +Projects below subgroups of the template group are **not** supported. + +Repository and database information that are copied over to each new project are +identical to the data exported with [GitLab's Project Import/Export](../project/settings/import_export.md). + +If you would like to set project templates at an instance level, please see [Custom instance-level project templates](../admin_area/custom_project_templates.md). \ No newline at end of file -- cgit v1.2.3 From 6d8f8bc121c2ecb2edecd4d696e8309631410ed3 Mon Sep 17 00:00:00 2001 From: Dennis Tang <750946-dennis@users.noreply.gitlab.com> Date: Fri, 30 Nov 2018 12:53:07 +0000 Subject: Update doc/user/group/index.md --- doc/user/group/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/user/group/index.md b/doc/user/group/index.md index 30680ab87d7..36b9318c0e0 100644 --- a/doc/user/group/index.md +++ b/doc/user/group/index.md @@ -262,7 +262,7 @@ Learn more about [Group-level file templates](https://docs.gitlab.com/ee/user/gr #### Group-level project templates **[PREMIUM]** Define project templates at a group-level by setting a group as a template source. -[Learn more about group-level project templates.](custom_project_templates.md) +[Learn more about group-level project templates](custom_project_templates.md). ### Advanced settings -- cgit v1.2.3 From fa7acd99e1b5385f5d818199d18ab62ebb39a24b Mon Sep 17 00:00:00 2001 From: Dennis Tang <750946-dennis@users.noreply.gitlab.com> Date: Fri, 30 Nov 2018 15:02:47 +0000 Subject: Clarify support of subgroups as project template source --- doc/user/group/custom_project_templates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/user/group/custom_project_templates.md b/doc/user/group/custom_project_templates.md index 0be9ea8226f..eaf0273050b 100644 --- a/doc/user/group/custom_project_templates.md +++ b/doc/user/group/custom_project_templates.md @@ -15,7 +15,7 @@ private projects will be available only if the user has view [permissions](../pe in the project. That is, users with Owner, Maintainer, Developer, Reporter or Guest roles for projects, or for groups to which the project belongs. -Projects below subgroups of the template group are **not** supported. +Projects of nested subgroups of a selected template source cannot be used. Repository and database information that are copied over to each new project are identical to the data exported with [GitLab's Project Import/Export](../project/settings/import_export.md). -- cgit v1.2.3