1 files changed, 15 insertions, 3 deletions
diff --git a/doc/user/namespace/index.md b/doc/user/namespace/index.md
index 9ffc65a4e8e..138b0a355ad 100644
--- a/doc/user/namespace/index.md
+++ b/doc/user/namespace/index.md
@@ -6,11 +6,23 @@ 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.
+  - 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: