Fix collaborating/create-organization.md

This commit is contained in:
Jeremy 2022-07-06 12:10:50 +12:00 committed by Gitea
parent fbd05b0037
commit bc300e5caa

View file

@ -7,11 +7,11 @@ eleventyNavigation:
--- ---
## What is an organization? ## What is an organization?
An organization is a group of users that have access to a shared account. As such, they can all access the different projects (repositories) of the organization. An organization can be composed of several teams, each having a defined role in the project's development and also different access rights. This makes organizations an easy and powerful tool to collaborate on a project. An organization is a group of users that have access to a shared account. As such, they can all access the different repositories of the organization. An organization can be composed of several teams, each having a defined role in the project's development and also different access rights. This makes organizations an easy and powerful tool to collaborate on a project.
Everyone can create organizations on Codeberg for free. The following sections will show you how to create and manage an organization. Everyone can create organizations on Codeberg for free. The following sections will show you how to create and manage an organization.
> Details about the roles involved (owner, admin, member...) are given in the section [Access rights](#access-rights) below. > Details about the roles involved (owner, admin, member, etc) are given in the section [Access rights](#access-rights) below.
## Create an Organization ## Create an Organization
On your Dashboard, click on the `+` next to your avatar and select `New Organization`: On your Dashboard, click on the `+` next to your avatar and select `New Organization`:
@ -21,19 +21,19 @@ On your Dashboard, click on the `+` next to your avatar and select `New Organiza
<img src="/assets/images/collaborating/create-organization/new-orga.png" alt="new-orga"> <img src="/assets/images/collaborating/create-organization/new-orga.png" alt="new-orga">
</picture> </picture>
In the new form, choose a name for your organization (here `PolarClub`) and define its visibility. Finally, choose what the administrators of repositories can do: if the box is ticked, repository administrators will be able to grant any team access to the repository (see [Access rights](#access-rights) below for details on repository administrators). In the new page, choose a name for your organization (here we choose `PolarClub`) and select its visibility. Finally, choose what the administrators of repositories can do; if the box is ticked, repository administrators will be able to grant any team access to the repository (see [Access rights](#access-rights) below for details on repository administrators).
Confirm by clicking the green `Create Organization`: Confirm by clicking `Create Organization`:
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/create-orga.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/create-orga.webp" type="image/webp">
<img src="/assets/images/collaborating/create-organization/create-orga.png" alt="create-orga"> <img src="/assets/images/collaborating/create-organization/create-orga.png" alt="create-orga">
</picture> </picture>
You are then directed to the organization's dashboard. You're now directed to the organization's dashboard.
## Switch between your personal account and the organization ## Switch between your personal account and the organization
On the dashboard, click on the avatar on the left and select the context (personal account or organization) you want to work with. Alternatively, access your repositories or your organization from the tabs on the right side. On the dashboard, click on the avatar on the left and select the context (personal account or organization) you want to work with. Alternatively, switch between your repositories or your organizations tabs on the right side.
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/dashboard.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/dashboard.webp" type="image/webp">
@ -48,24 +48,24 @@ The organization's dashboard gives you an overview of the organization:
<img src="/assets/images/collaborating/create-organization/view-orga.png" alt="view-orga"> <img src="/assets/images/collaborating/create-organization/view-orga.png" alt="view-orga">
</picture> </picture>
If you click on the `View [name of organization]` (here `PolarClub`), you will be directed to the organization's page: If you click on the `View [organization]` (here `PolarClub`, you'll be directed to the organization's page:
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/orga.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/orga.webp" type="image/webp">
<img src="/assets/images/collaborating/create-organization/orga.png" alt="orga"> <img src="/assets/images/collaborating/create-organization/orga.png" alt="orga">
</picture> </picture>
From there, you can access all repositories (there is none in this example) and create a new one. There is a list of all the members (`People`) and teams; in this example, there is only one member (Knut the polar bear), and one team (`Owners`) with one member (yourself) and no repository. From here, you can access all repositories (there's currently none here) and create new ones. There's a list of all the members (`People`) and teams; in this example, there is only one member (Knut the polar bear), and one team (`Owners`) with one member (yourself) and no repositories.
## Edit organization ## Edit organization
The cog next to the organization's name will lead you to the organization's settings: The cog next to the organization's name will lead you to its settings:
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/cog.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/cog.webp" type="image/webp">
<img src="/assets/images/collaborating/create-organization/cog.png" alt="cog"> <img src="/assets/images/collaborating/create-organization/cog.png" alt="cog">
</picture> </picture>
This is where you can change general settings related to your organization, such as its name, avatar, website or visibility. It is also where you can delete your organization, and access more advanced settings like organization webhooks: This is where you can change general settings related to your organization, such as its name, avatar, website or visibility. You can also delete your organization, and access more advanced settings like organization webhooks:
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/orga-settings.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/orga-settings.webp" type="image/webp">
@ -76,19 +76,19 @@ The `Name` of the organization is the name that will define the URLs of the orga
In the `Labels` tab, you can create labels that will be used across all repositories of this organization. This will help with issues and pull requests. The default label set is a good starting point. In the `Labels` tab, you can create labels that will be used across all repositories of this organization. This will help with issues and pull requests. The default label set is a good starting point.
In the top right corner, you have access to the people (members) and teams of your organization. These can also be accessed from the organization's page. In the top right corner, you have access to the members and teams of your organization. These can also be accessed from the organization's page.
## Teams ## Teams
The `Teams` tab gives you an overview of the different teams, of their members and of their number of repositories. You can also join a team from there if you have the permission to do so: The `Teams` tab gives you an overview of all the teams, their members and their number of repositories. You can also join a team from here if you have the permission to do so:
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/teams.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/teams.webp" type="image/webp">
<img src="/assets/images/collaborating/create-organization/teams.png" alt="teams"> <img src="/assets/images/collaborating/create-organization/teams.png" alt="teams">
</picture> </picture>
When you create an organization, a team `Owners` is created and you are automatically added to this team. Members of the Owners' team have all rights (see [Access rights](#access-rights) below for details). When you create an organization, a team `Owners` is created and you are automatically added to this team. Members of the Owners' team have all permissions (see [Access rights](#access-rights) below for details).
Click the green `+ New Team` to create a new team. Define its name, permissions and access in the new form: Click the `+ New Team` button to create a new team. Now, in the new page, you can set its name, permissions, and accessible repositories.
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/new-team.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/new-team.webp" type="image/webp">
@ -96,12 +96,12 @@ Click the green `+ New Team` to create a new team. Define its name, permissions
</picture> </picture>
You can choose whether members of the team can only access some repositories explicitly added to the team, or whether they can access all repositories of the organization. You can choose whether members of the team can only access some repositories explicitly added to the team, or whether they can access all repositories of the organization.
You can also allow members to be able to create new repositories for the organization. You can also allow members to be able to create new repositories on behalf of the organization.
If you have allowed repository administrators to grant or remove access for teams (see [Create an Organization](#create-an-organization) above), they can do so in `Settings > Collaborators` tab of the repository. If you have allowed repository administrators to grant or remove access for teams (see [Create an Organization](#create-an-organization) above), they can do so in the `Settings → Collaborators` tab of the repository.
If you choose either `Read` or `Write` access, you can additionally define which sections of the repositories (code, issues, pull requests, releases and wiki) the members will have (read or write) access to. On the other hand, `Administrator` access automatically grants read and write access to all sections; this part of the form is therefore hidden in this case. If you allow either `Read` or `Write` access, you can additionally set which sections of the repositories (code, issues, pull requests, releases and wiki) the members will have (read or write) access to. On the other hand, `Administrator Access` automatically grants read and write access to all sections; this part of the page is hidden in this case.
See the section [Access rights](#access-rights) below for details. See the section [Access rights](#access-rights) below for details.
If you belong to the team `Owners`, you can edit a team. For this, go to the `Teams` tab and click on the team you want to edit: If you belong to the team `Owners`, you can edit teams. To do this, go to the `Teams` tab and click on the team you want to edit:
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/team-settings.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/team-settings.webp" type="image/webp">
@ -109,7 +109,7 @@ If you belong to the team `Owners`, you can edit a team. For this, go to the `Te
</picture> </picture>
Click on `Settings` to edit the team as shown above for the creation of a team. Click on `Settings` to edit the team as shown above for the creation of a team.
This is also where you can add or remove members to a team, and assign repositories to a team. This is also where you can add or remove members to/from a team, and assign repositories to them.
## People ## People
On the `People` tab, you can get an overview of all the people who belong to your organization: On the `People` tab, you can get an overview of all the people who belong to your organization:
@ -119,23 +119,23 @@ On the `People` tab, you can get an overview of all the people who belong to you
<img src="/assets/images/collaborating/create-organization/people.png" alt="people"> <img src="/assets/images/collaborating/create-organization/people.png" alt="people">
</picture> </picture>
Somewhat counter-intuitively, this is not where you can add members; this is done in the `Teams` tab (see [Teams](#teams) above). But you can remove members from the `People` tab. Somewhat counter-intuitively, this is not where you can add members; this is done in the `Teams` tab (see [Teams](#teams) above). However, you can remove members from the `People` tab.
The visibility of the members can also be edited here: `Hidden` means that the memberships of the members will not be shown on their profiles, while `Visible` makes the avatar of the organization appear in the info card on their profile, as shown in the screenshot below. Note that your membership will always be visible to you on your profile; this visibility setting is for other users only. The visibility of the members can also be edited here; `Hidden` means that the members' memberships will not be shown on their profiles, while `Visible` makes the avatar of the organization appear in the info card on their profile, as shown in the screenshot below. Note that your membership will always be visible to you on your profile; this visibility setting is for other users only.
<picture> <picture>
<source srcset="/assets/images/collaborating/create-organization/profile.webp" type="image/webp"> <source srcset="/assets/images/collaborating/create-organization/profile.webp" type="image/webp">
<img src="/assets/images/collaborating/create-organization/profile.png" alt="profile"> <img src="/assets/images/collaborating/create-organization/profile.png" alt="profile">
</picture> </picture>
It is also shown here whether each member has activated the two-factor authentification (`2FA`, see [Setting up Two-factor Authentication](/security/2fa)). Shown here is also whether or not each member has activated two-factor authentication (2FA, see [Setting up Two-factor Authentication](/security/2fa)).
Finally, you can choose to leave the organization from here. Finally, from here you can choose to leave the organization.
## Access rights ## Access rights
An overview of the repository permissions in given in the article [Repository Permissions](/collaborating/repo-permissions). An overview of the repository permissions is given in the article [Repository Permissions](/collaborating/repo-permissions).
Members of the "Owners" team can do everything that admins can do. But only owners of the organization can manage the organization, which includes: Members of the "Owners" team can do everything that admins can do. However, only owners of the organization can manage the organization, which includes:
- edit/delete the organization, - edit/delete the organization,
- add/remove members and teams, - add/remove members and teams,
- define access rights of teams, - define access rights of teams,