From bdff9f6eac3562688b5afb82f63ca2ad5cb6eea9 Mon Sep 17 00:00:00 2001 From: Asutosh Panda <crispyasutoshpanda2@gmail.com> Date: Tue, 23 Aug 2022 09:49:25 +0000 Subject: [PATCH] Add more self-explanatory content on Namespace --- doc/user/namespace/index.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/doc/user/namespace/index.md b/doc/user/namespace/index.md index 9ffc65a4e8e52..172be7873a7fc 100644 --- a/doc/user/namespace/index.md +++ b/doc/user/namespace/index.md @@ -6,11 +6,24 @@ info: To determine the technical writer assigned to the Stage/Group associated w # Namespaces -In GitLab, a *namespace* organizes related projects together. +In GitLab, a *namespace* provides one place to organize your related projects. Projects in one namespace are separate from projects in other namespaces, +which means you can use the same name for projects in different namespaces. + GitLab has two types of namespaces: -- A *personal* namespace, which is based on your username. Projects under a personal namespace must be configured one at a time. -- A *group* or *subgroup* namespace. In these namespaces, you can manage multiple projects at once. +- A *Personal* namespace, which is based on your username and provided to you when you create your account. + - If you change your username, the project and namespace URLs in your account also change. Before you change your username, + read about [repository redirects](../project/repository/index.md#what-happens-when-a-repository-path-changes). + - You cannot create subgroups in a personal namespace. + - Groups in your namespace do not inherit your namespace permissions and group features. + - Creating subgroups under this namespace is not allowed. + - All the *Personal Projects* created will fall under the scope of this namespace. + +- A *group* or *subgroup* namespace: + - You can create multiple subgroups to manage multiple projects. + - You can change the URL of group and subgroup namespaces. + - You can configure settings specifically for each subgroup and project in the namespace. + - When you create a subgroup, it inherits some of the parent group settings. You can view these in the subgroup **Settings**. To determine whether you're viewing a group or personal namespace, you can view the URL. For example: -- GitLab