From 3479a78e96cdcaac20b2173008c0b9f1823a90f6 Mon Sep 17 00:00:00 2001
From: Madalena Melo <144885032+madalenapmelo-kp@users.noreply.github.com>
Date: Tue, 26 Nov 2024 13:06:08 +0100
Subject: [PATCH 1/3] Viewer Role - Update index.njk

Add viewer role to the team roles; also made some tweaks to the descriptions of the other roles
---
 docs/user-guide/teams/index.njk | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/user-guide/teams/index.njk b/docs/user-guide/teams/index.njk
index 96d7968133..a72adefa17 100644
--- a/docs/user-guide/teams/index.njk
+++ b/docs/user-guide/teams/index.njk
@@ -36,9 +36,10 @@ member is allowed to do depends on their permissions.</p>
 <h3>Team roles</h3>
 <p>These are the team roles currently available at Penpot:</p>
 <ul>
-  <li><strong>Owner:</strong> There's only one owner per team, the role is automatically assigned to the team creator. Owners have permissions to change every other member role, including transfering ownership. Owners can update team settings, invite members and delete teams.</strong></li>
-  <li><strong>Admin:</strong> Permissions to change every other member role except owners. Can invite members and update team settings.</strong></li>
-  <li><strong>Editor:</strong> Without permissions to change member roles, invite members or update team settings.</strong></li>
+  <li><strong>Owner:</strong> There's only one owner per team, the role is automatically assigned to the team creator. Owners have permissions to change every other member's role, including transfering ownership. Owners can update team settings, invite members and delete teams.</strong></li>
+  <li><strong>Admin:</strong> Admins can change every other member's role except owners. They can invite members and update team settings.</strong></li>
+  <li><strong>Editor:</strong> Editors can edit and create files and projects, but do not have permissions to change member roles, invite members or update team settings.</strong></li>
+  <li><strong>Viewer:</strong> Viewers can view projects and files but will not be able to edit them; they also do not have permissions to change member roles, invite members or update team settings.</strong></li>
 </ul>
 <figure><img src="/img/teams/teams-permissions.webp" alt="Team members" /></figure>
 <p class="advice">More team roles will be eventually available, as well as fine grained permissions management to control members access and actions.</p>

From 58bc772880b92f8f1b9d3375c105ee5667731d52 Mon Sep 17 00:00:00 2001
From: Madalena Melo <144885032+madalenapmelo-kp@users.noreply.github.com>
Date: Tue, 3 Dec 2024 15:50:35 +0100
Subject: [PATCH 2/3] Add detail to role descriptions

Added more context to each role's description; I tried to keep it brief while including more information about what each role can do both within the team as well as in terms of team management
---
 docs/user-guide/teams/index.njk | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/user-guide/teams/index.njk b/docs/user-guide/teams/index.njk
index a72adefa17..45b216e1b3 100644
--- a/docs/user-guide/teams/index.njk
+++ b/docs/user-guide/teams/index.njk
@@ -36,10 +36,10 @@ member is allowed to do depends on their permissions.</p>
 <h3>Team roles</h3>
 <p>These are the team roles currently available at Penpot:</p>
 <ul>
-  <li><strong>Owner:</strong> There's only one owner per team, the role is automatically assigned to the team creator. Owners have permissions to change every other member's role, including transfering ownership. Owners can update team settings, invite members and delete teams.</strong></li>
-  <li><strong>Admin:</strong> Admins can change every other member's role except owners. They can invite members and update team settings.</strong></li>
-  <li><strong>Editor:</strong> Editors can edit and create files and projects, but do not have permissions to change member roles, invite members or update team settings.</strong></li>
-  <li><strong>Viewer:</strong> Viewers can view projects and files but will not be able to edit them; they also do not have permissions to change member roles, invite members or update team settings.</strong></li>
+  <li><strong>Owner:</strong> There's only one owner per team, the role is automatically assigned to the team creator. Owners have full access to the team's projects and permissions to change every other member's role, including transfering ownership. Owners can update team settings, invite members and delete teams.</strong></li>
+  <li><strong>Admin:</strong> Admins have full access to the team's projects and can change every other member's role except owners. They can invite members and update team settings.</strong></li>
+  <li><strong>Editor:</strong> Editors can create, import, edit and manage files and libraries, but do not have permissions to manage team settings.</strong></li>
+  <li><strong>Viewer:</strong> Viewers can view, comment on and inspect files but will not be able to edit them; they also do not have permissions to manage team settings.</strong></li>
 </ul>
 <figure><img src="/img/teams/teams-permissions.webp" alt="Team members" /></figure>
 <p class="advice">More team roles will be eventually available, as well as fine grained permissions management to control members access and actions.</p>

From c5ec3ea7b1a3476b924f194263125ad9a8c7b5eb Mon Sep 17 00:00:00 2001
From: Madalena Melo <144885032+madalenapmelo-kp@users.noreply.github.com>
Date: Wed, 4 Dec 2024 12:09:34 +0100
Subject: [PATCH 3/3] Change the order to add clarity to admin and owner roles

Switched the order of the roles to make it more logical and add more clarity about admins and owners ability to edit
---
 docs/user-guide/teams/index.njk | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/user-guide/teams/index.njk b/docs/user-guide/teams/index.njk
index 45b216e1b3..47920629d0 100644
--- a/docs/user-guide/teams/index.njk
+++ b/docs/user-guide/teams/index.njk
@@ -36,10 +36,10 @@ member is allowed to do depends on their permissions.</p>
 <h3>Team roles</h3>
 <p>These are the team roles currently available at Penpot:</p>
 <ul>
-  <li><strong>Owner:</strong> There's only one owner per team, the role is automatically assigned to the team creator. Owners have full access to the team's projects and permissions to change every other member's role, including transfering ownership. Owners can update team settings, invite members and delete teams.</strong></li>
-  <li><strong>Admin:</strong> Admins have full access to the team's projects and can change every other member's role except owners. They can invite members and update team settings.</strong></li>
+  <li><strong>Viewer:</strong> Viewers can view, comment on and inspect files but will not be able to edit them, nor do they have permissions to manage team settings.</strong></li>
   <li><strong>Editor:</strong> Editors can create, import, edit and manage files and libraries, but do not have permissions to manage team settings.</strong></li>
-  <li><strong>Viewer:</strong> Viewers can view, comment on and inspect files but will not be able to edit them; they also do not have permissions to manage team settings.</strong></li>
+  <li><strong>Admin:</strong> Admins have the same permissions as editors, with the added ability to change every other member's role except owners. They can invite members and update team settings.</strong></li>
+  <li><strong>Owner:</strong> There's only one owner per team, the role is automatically assigned to the team creator. Owners have all the permissions of admins, with the additional ability to change any member's role, including transferring ownership. Owners can update team settings, invite members and delete teams.</strong></li>
 </ul>
 <figure><img src="/img/teams/teams-permissions.webp" alt="Team members" /></figure>
 <p class="advice">More team roles will be eventually available, as well as fine grained permissions management to control members access and actions.</p>