From f77f0c813053b83c8c372cde84c10f50d0bddc47 Mon Sep 17 00:00:00 2001
From: Sachin Chaurasiya <sachinchaurasiyachotey87@gmail.com>
Date: Tue, 4 Oct 2022 15:27:39 +0530
Subject: [PATCH] Fix how to guides broken link (#7923)

---
 .../content/how-to-guides/index.md            |  8 ++++
 .../how-to-organise-teams-and-users.md        | 40 +++++++++++++++++++
 .../how-to-guides/teams-and-users/index.md    | 22 +---------
 3 files changed, 50 insertions(+), 20 deletions(-)
 create mode 100644 openmetadata-docs/content/how-to-guides/index.md
 create mode 100644 openmetadata-docs/content/how-to-guides/teams-and-users/how-to-organise-teams-and-users.md

diff --git a/openmetadata-docs/content/how-to-guides/index.md b/openmetadata-docs/content/how-to-guides/index.md
new file mode 100644
index 00000000000..723de36f933
--- /dev/null
+++ b/openmetadata-docs/content/how-to-guides/index.md
@@ -0,0 +1,8 @@
+---
+title: How to Guides
+slug: /how-to-guides
+---
+
+# How to Guides
+
+How to Guides will give you a walk through on `How to do things in OpenMetadata`.
diff --git a/openmetadata-docs/content/how-to-guides/teams-and-users/how-to-organise-teams-and-users.md b/openmetadata-docs/content/how-to-guides/teams-and-users/how-to-organise-teams-and-users.md
new file mode 100644
index 00000000000..16f773edc99
--- /dev/null
+++ b/openmetadata-docs/content/how-to-guides/teams-and-users/how-to-organise-teams-and-users.md
@@ -0,0 +1,40 @@
+---
+title: How To Organise Teams And users
+slug: /how-to-guides/teams-and-users/how-to-organise-teams-and-users
+---
+
+# Team structure in OpenMetadata
+
+In OpenMetadata we have hierarchal team structure with `teamType` that can be `Organization`, `Business Unit`, `Division`, `Department`, and `Group` (default team type).
+
+- `Organization` is the root team in the hierarchy. _It can't have a parent_. It can have children of type `Business Unit`, `Division`, `Department`, `Group` along with `Users` directly as children (who are without teams).
+
+- `BusinessUnit` is the next level of the team in the hierarchy. It can have `Business Unit`, `Division`, `Department`, and `Group` as children. It can only have ** one parent ** either of type `Organization`, or `Business Unit`.
+
+- `Division` is the next level of the team in the hierarchy below `Business Unit`. It can have `Division`, `Department`, and `Group` as children. It can only have ** one parent ** of type `Organization`, `Business Unit`, or `Division`.
+
+- `Department` is the next level of the team in the hierarchy below `Division`. It can have `Department` and `Group` as children. It can have `Organization`, `Business Unit`, `Division`, or `Department` as parents. ** It can have multiple parents **.
+
+- `Group` is the last level of the team in the hierarchy. It can have only `Users` as children and not any other teams. It can have all the team types as parents. ** It can have multiple parents **.
+
+<Image src="/images/how-to-guides/teams-and-users/teams-structure.png" alt="team-structure"/>
+<br/>
+<br/>
+
+## How to change the team type
+
+Let's say you have team `Cloud_Infra` of type `Department` and you want to change it to the type `BusinessUnit`, you can easily do that through UI.
+
+1. Click on the `Cloud_Infra` team name and it will take you to the `Cloud_Infra` details page.
+   <Image src="/images/how-to-guides/teams-and-users/cloud-infra.png" alt="cloud-infra"/>
+   <br/>
+   <br/>
+2. On details page you will see the `Type - Department` with edit button.
+   <Image src="/images/how-to-guides/teams-and-users/team-type.png" alt="team-type"/>
+   <br/>
+   <br/>
+3. Now Click on the edit button and you will get a set of options and from them select `BusinessUnit` and click on ✅ to save it.
+   <Image src="/images/how-to-guides/teams-and-users/select-team-type.png" alt="select-team-type"/>
+   <br/>
+   <br/>
+4. Now you can see `Cloud_Infra` team type changed to `BusinessUnit` from `Department`.
diff --git a/openmetadata-docs/content/how-to-guides/teams-and-users/index.md b/openmetadata-docs/content/how-to-guides/teams-and-users/index.md
index 16f773edc99..49baf34b93c 100644
--- a/openmetadata-docs/content/how-to-guides/teams-and-users/index.md
+++ b/openmetadata-docs/content/how-to-guides/teams-and-users/index.md
@@ -1,6 +1,6 @@
 ---
-title: How To Organise Teams And users
-slug: /how-to-guides/teams-and-users/how-to-organise-teams-and-users
+title: Team structure in OpenMetadata
+slug: /how-to-guides/teams-and-users
 ---
 
 # Team structure in OpenMetadata
@@ -20,21 +20,3 @@ In OpenMetadata we have hierarchal team structure with `teamType` that can be `O
 <Image src="/images/how-to-guides/teams-and-users/teams-structure.png" alt="team-structure"/>
 <br/>
 <br/>
-
-## How to change the team type
-
-Let's say you have team `Cloud_Infra` of type `Department` and you want to change it to the type `BusinessUnit`, you can easily do that through UI.
-
-1. Click on the `Cloud_Infra` team name and it will take you to the `Cloud_Infra` details page.
-   <Image src="/images/how-to-guides/teams-and-users/cloud-infra.png" alt="cloud-infra"/>
-   <br/>
-   <br/>
-2. On details page you will see the `Type - Department` with edit button.
-   <Image src="/images/how-to-guides/teams-and-users/team-type.png" alt="team-type"/>
-   <br/>
-   <br/>
-3. Now Click on the edit button and you will get a set of options and from them select `BusinessUnit` and click on ✅ to save it.
-   <Image src="/images/how-to-guides/teams-and-users/select-team-type.png" alt="select-team-type"/>
-   <br/>
-   <br/>
-4. Now you can see `Cloud_Infra` team type changed to `BusinessUnit` from `Department`.