unleash.unleash/project-collaboration-mode.md at 9cb015a7dbaa64e1fe4b46d41a33f4d07561a015

mirror of https://github.com/Unleash/unleash.git synced 2024-10-28 19:06:12 +01:00

add custom root roles to docs on private projects (#5829 )

<!-- 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>

2024-03-12 16:42:41 +01:00

2.6 KiB

Raw Blame History

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. There are two collaboration modes:

open
protected
private

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.

2.6 KiB Raw Blame History