mirror of
https://github.com/Unleash/unleash.git
synced 2024-11-01 19:07:38 +01:00
34729e8205
<!-- Thanks for creating a PR! To make it easier for reviewers and everyone else to understand what your changes relate to, please add some relevant content to the headings below. Feel free to ignore or delete sections that you don't think are relevant. Thank you! ❤️ --> ## About the changes <!-- Describe the changes introduced. What are they and why are they being introduced? Feel free to also add screenshots or steps to view the changes if they're visual. --> <!-- Does it close an issue? Multiple? --> Closes # <!-- (For internal contributors): Does it relate to an issue on public roadmap? --> <!-- Relates to [roadmap](https://github.com/orgs/Unleash/projects/10) item: # --> ### Important files <!-- PRs can contain a lot of changes, but not all changes are equally important. Where should a reviewer start looking to get an overview of the changes? Are any files particularly important? --> ## Discussion points <!-- Anything about the PR you'd like to discuss before it gets merged? Got any questions or doubts? --> --------- Co-authored-by: Thomas Heartman <thomas@getunleash.io>
54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
---
|
|
title: Project Collaboration Mode
|
|
---
|
|
|
|
:::info Availability
|
|
|
|
The project collaboration mode is an enterprise-only feature that was introduced in **Unleash 4.22.0**.
|
|
|
|
:::
|
|
|
|
A project's **collaboration mode** specifies **who can submit [change requests](change-requests.md)**. There are two collaboration modes:
|
|
- [**open**](#open-collaboration-mode)
|
|
- [**protected**](#protected-collaboration-mode)
|
|
- [**private**](#private-collaboration-mode)
|
|
|
|
## **Open** collaboration mode
|
|
|
|
Anyone can submit change requests in an **open** project, regardless of their permissions within the project and globally. This is the default collaboration mode for projects.
|
|
|
|
The open collaboration mode is the default in Unleash and is how all projects worked in Unleash before the introduction of collaboration modes.
|
|
|
|
## **Protected** collaboration mode
|
|
|
|
Only admins and project members can submit change requests in a **protected** project. Other users can not submit change requests.
|
|
|
|
## **Private** collaboration mode
|
|
|
|
Private collaboration mode renders the project invisible to all **viewers** who are not project members. This means that **viewers** cannot see the project in the project list, nor can they access the project's features or locate the project anywhere within Unleash.
|
|
|
|
**Editors**, **admins**, and users with **custom root roles** can still see private projects.
|
|
|
|
### Change requests
|
|
|
|
When you change a project's collaboration mode from open to protected, users who do not have the right permissions will lose the ability to create new change requests.
|
|
|
|
However, existing change requests created by these users will not be deleted. Any users with open change requests will still be able to cancel the change request, but they will **not** be able to update the change request.
|
|
|
|
## Project collaboration mode setting
|
|
|
|
The collaboration mode for a project can be set at the time of creation and modified at any subsequent time, found within the 'Enterprise Settings' section.
|
|
|
|
|
|
|
|
Since the collaboration mode is an integral feature of the project, the options to modify it can be found on the 'Project Settings' page.
|
|
|
|
|
|
|
|
## Pre-existing projects
|
|
|
|
Projects that were created in earlier versions of Unleash (before the release of project collaboration modes) get the **open** mode when they are migrated to a version of Unleash with project collaboration modes.
|
|
|
|
To change the project collaboration mode for an existing project you have to edit the project.
|
|
|