Documentation/content/collaborating/invite-collaborators.md
Javier Pérez c6ac9a9f94 Reduce line length limit and format content (#623)
# Changelog

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## Changed

- Update line length limit from 500 characters to 120 characters.

## Fixed

- Most instances of these lint issues:
  1. Lines longer than 120 characters ([MD013](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md013.md)).
  2. Trailing whitespaces ([MD009](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md)).
  3. Ordered list item prefix ([MD029](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md029.md)).
  4. Bare links ([MD034](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md034.md)).

Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/623
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: Javier Pérez <walpo@noreply.codeberg.org>
Co-committed-by: Javier Pérez <walpo@noreply.codeberg.org>
2025-06-14 11:38:21 +02:00

37 lines
2 KiB
Markdown

---
eleventyNavigation:
key: InviteCollaborators
title: Invite Collaborators
parent: Collaborating
order: 30
---
## Why invite collaborators?
If your project repository is public (see [Your First Repository](/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. This is contributing, but not collaborating, since you're still the only one who can _directly_ commit
changes to your repository.
On the other hand, if your repository is private, only you, your collaborators and the members of your organization
(depending on their permissions, see [Create and Manage an Organization](/collaborating/create-organization)) 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 they have a Codeberg account (see [Your First Steps on Codeberg](/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.
<img src="/images/collaborating/invite-collaborators/settings.png" alt="settings">
Then navigate to the `Collaborators` tab and search for the user you want to add, then click on `Add Collaborator`.
<img src="/images/collaborating/invite-collaborators/add-collaborator.png" alt="add-collaborator">
Once added, you can define the access rights by clicking on the shield: `Read`, `Write` or `Administrator`
(see [Repository Permissions](/collaborating/repo-permissions) for details).
This is also where you can remove collaborators.
<img src="/images/collaborating/invite-collaborators/collaborator-rights.png" alt="collaborator-rights">