From 72fc329d155fac2d2cdee6e36f225566275b6046 Mon Sep 17 00:00:00 2001
From: Thomas Heartman <thomas.heartman+git@gmail.com>
Date: Thu, 6 Jan 2022 14:44:18 +0100
Subject: [PATCH] docs: explain what the project and env permissions mean for
 CPR

---
 website/docs/user_guide/rbac.md | 43 ++++++++++++++++++++++++++-------
 1 file changed, 34 insertions(+), 9 deletions(-)

diff --git a/website/docs/user_guide/rbac.md b/website/docs/user_guide/rbac.md
index c4186bf8e5..d60c4a2ee1 100644
--- a/website/docs/user_guide/rbac.md
+++ b/website/docs/user_guide/rbac.md
@@ -53,17 +53,42 @@ Each custom project role consists of:
 
 You can assign the following project permissions. The permissions will be valid across all of the project's environments.
 
-- update the project
-- delete the project
-- create feature toggles within the project
-- update feature toggles within the project
-- delete feature toggles within the project
+- **update the project**
+
+  Lets the user update project settings, such as enabling/disabling environments, add users, etc.
+
+- **delete the project**
+
+  Lets the user delete the project.
+
+- **create feature toggles within the project**
+
+  Lets the user create feature toggles within the project. Note that they **can not assign strategies** to toggles without having the _create feature toggle_ permission for the corresponding environment.
+
+- **update feature toggles within the project**
+
+  Lets the user update feature toggle descriptions, variants, settings, etc. within the project.
+
+- **delete feature toggles within the project**
+
+  Lets the user delete feature toggles within the project.
 
 ### Environment permissions
 
 You can assign the following permissions on a per-environment level within the project:
 
-- create feature strategies
-- update feature strategies
-- delete feature strategies
-- enable/disable toggles
+- **create feature strategies**
+
+  Lets the user assign feature toggle strategies within the environment.
+
+- **update feature strategies**
+
+  Lets the user update feature toggle strategies within the environment.
+
+- **delete feature strategies**
+
+  Lets the user delete feature toggle strategies within the environment.
+
+- **enable/disable toggles**
+
+  Lets the user enable and disable toggles within the environment.