doc : Add how to guide section to the doc (#7919)

* doc : Add how to guide section to the doc

* Fix slug

* Fix menu.md issue

* Add "How to change the team type" guide
This commit is contained in:
Sachin Chaurasiya 2022-10-04 14:37:24 +05:30 committed by GitHub
parent 895b2a35c3
commit f3e6266b7a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 50 additions and 0 deletions

View File

@ -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`.

View File

@ -168,6 +168,16 @@ site_menu:
- category: Deployment / Airflow
url: /deployment/airflow
- category: How to guides
url: /how-to-guides
color: violet-70
icon: openmetadata
- category: How to guides / Teams and Users
url: /how-to-guides/teams-and-users
- category: How to guides / Teams and Users / How to Organise Teams and Users
url: /how-to-guides/teams-and-users/how-to-organise-teams-and-users
- category: OpenMetadata
url: /openmetadata
color: violet-70

Binary file not shown.

After

Width:  |  Height:  |  Size: 986 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 903 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 833 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB