Invite collaborators and Create organization

content/collaborating/create-organization.md

@@ -0,0 +1,65 @@
+---
+eleventyNavigation:
+  key: CreateOrganization
+  title: Create and Manage an Organization
+  parent: Collaborating
+  order: 40
+---
+
+## 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 possibly having a defined role in the project's development. Owners and administrators can define the access rights of each team.
+
+## Create an Organization
+On your Dashboard, click on the `+` next to your avatar and select `New Organization`:
+
+![new-orga](/assets/images/collaborating/create-organization/NewOrga.PNG)
+
+In the new form, choose a name for your organization (here "PolarClub"), define its visibility and choose what the administrators of repositories can do. Validate by clicking the green `Create Organization`: 
+
+![create-orga](/assets/images/collaborating/create-organization/Create-orga.PNG)
+
+You are then directed to the organization's dashboard.
+
+## Switch between your account and the organization
+On the dashboard, click on the avatar at the left and select the context you want to work with:
+
+![switch-context](/assets/images/collaborating/create-organization/switch-context.PNG)
+
+## View organization
+The organization's dashboard gives you an overview of the organization:
+
+![view-orga](/assets/images/collaborating/create-organization/ViewOrga.PNG)
+
+If you click on the `View [name of organization]` (here `PolarClub`), you will be directed to the organization's page:
+
+![orga](/assets/images/collaborating/create-organization/Orga.PNG)
+
+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 1 member (Knut the polar bear), and 1 team (`Owners`) with 1 member and no repository. 
+
+## Edit organization
+The cog will lead you to the organization's settings, where you can change the organization's name; add a full name, a description, a link to a website and a location; change the visibility and persmissions; and add/change the avatar:
+
+![settings](/assets/images/collaborating/create-organization/orga-settings.png)
+
+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.
+
+## 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: 
+
+![teams](/assets/images/collaborating/create-organization/teams.PNG)
+
+Click the green `+ New Team` to create a new team. Define the name, permissions and access in the new form:
+
+![new-team](/assets/images/collaborating/create-organization/new-team.png)
+
+To edit a team, go to the `Teams` tab and click on the team you want to edit:
+
+![new-team](/assets/images/collaborating/create-organization/team-settings.png)
+
+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.
+
+## People

content/collaborating/index.md

@@ -3,7 +3,7 @@ eleventyNavigation:
   key: Collaborating
   title: Collaborating with Others
   icon: user-friends
-  order: 30
+  order: 10
 ---
 
 These documentation pages contain detailed information on how you can collaborate 

content/collaborating/invite-collaborators.md

@@ -0,0 +1,26 @@
+---
+eleventyNavigation:
+  key: InviteCollaborators
+  title: Invite Collaborators
+  parent: Collaborating
+  order: 30
+---
+
+## Why invite collaborators?
+If your project repository is public (see [Your first Repository](/content/getting-started/first-repository) on how to set up the visibility of a repository), everyone can see your repository and every Codeberg user can contribute through issues and pull requests. But this is not collaborating since you will be have to fix the issues and deal with the pull requests on your own.    
+On the other hand, if your repository is private, only you, your collaborators and the members of your organization (depending on their rights, see [Create and Manage an Organization](/content/collaborating/organizations)) can access your repository. In other words, if you want Codeberg users outside of your organization to be able to work with you on your project, you have to grant them access to your repository by adding them as *collaborators*.
+
+It is important to understand that only registered Codeberg users can contribute. If you want a colleague or friend to work with you, you first have to make sure he/she has a Codeberg account (see [Your First Steps on Codeberg](/content/getting-started/first-steps)).
+
+## Add a collaborator
+To add a user to a repository as a collaborator, first go to the settings of your repository.
+
+![settings](/assets/images/collaborating/invite-collaborators/settings.PNG)
+
+Then navigate to the `Collaborators` tab and search for the user you want to add, and click on `Add Collaborator`.
+
+![add-collaborator](/assets/images/collaborating/invite-collaborators/add-collaborator.PNG)
+
+Once added, you can define the access rights by clicking on the shield: `Read` (can see but not edit), `Write` (can see and edit) or `Administrator` (can do everything!). This is also where you can remove collaborators.
+
+![collaborator-rights](/assets/images/collaborating/invite-collaborators/collaborator-rights.PNG)

content/collaborating/pull-requests-and-git-flow.md

@@ -3,6 +3,7 @@ eleventyNavigation:
   key: PullRequestsGitFlow
   title: Pull requests and Git flow
   parent: Collaborating
+  order: 20
 ---
 
 ## Benefits of a pull-request based workflow