From 7baaa0b713620c8ed9f2fa24a2233e3007110fb5 Mon Sep 17 00:00:00 2001
From: Henri Courdent <122811744+hcourdent@users.noreply.github.com>
Date: Tue, 18 Jul 2023 11:13:17 +0200
Subject: [PATCH] Added Tooltips and Documentation Links on user management
 (#1803)

---
 frontend/src/lib/components/AddUser.svelte    |  8 +++++---
 .../src/lib/components/FolderEditor.svelte    |  2 +-
 frontend/src/lib/components/InviteUser.svelte |  8 +++++---
 .../(root)/(logged)/audit_logs/+page.svelte   |  1 +
 .../(logged)/workspace_settings/+page.svelte  | 19 +++++++++++++------
 5 files changed, 25 insertions(+), 13 deletions(-)

diff --git a/frontend/src/lib/components/AddUser.svelte b/frontend/src/lib/components/AddUser.svelte
index 4192442ca0..10c08d0134 100644
--- a/frontend/src/lib/components/AddUser.svelte
+++ b/frontend/src/lib/components/AddUser.svelte
@@ -75,15 +75,17 @@
 		<ToggleButton position="left" value="operator" size="sm"
 			>Operator <Tooltip
 				>An operator can only execute and view scripts/flows/apps from your workspace, and only
-				those that he has visibility on</Tooltip
+				those that he has visibility on.</Tooltip
 			></ToggleButton
 		>
 		<ToggleButton position="center" value="author" size="sm"
 			>Author <Tooltip
-				>An Author can execute and view scripts/flows/apps, but he can also create new ones</Tooltip
+				>An Author can execute and view scripts/flows/apps, but he can also create new ones.</Tooltip
 			></ToggleButton
 		>
-		<ToggleButton position="right" value="admin" size="sm">Admin</ToggleButton>
+		<ToggleButton position="right" value="admin" size="sm">Admin<Tooltip
+			>An admin has full control over a specific Windmill workspace, including the ability to manage users, edit entities, and control permissions within the workspace.</Tooltip
+		></ToggleButton>
 	</ToggleButtonGroup>
 	<Button
 		variant="contained"
diff --git a/frontend/src/lib/components/FolderEditor.svelte b/frontend/src/lib/components/FolderEditor.svelte
index 0e0a7a52a3..a07af51eb5 100644
--- a/frontend/src/lib/components/FolderEditor.svelte
+++ b/frontend/src/lib/components/FolderEditor.svelte
@@ -279,7 +279,7 @@
 										>
 										<ToggleButton position="center" value="writer" size="xs"
 											>Writer&nbsp;<Tooltip
-												>A viewer of a folder has read AND write access to all the elements
+												>A writer of a folder has read AND write access to all the elements
 												(scripts/flows/apps/schedules/resources/variables) inside the folder</Tooltip
 											></ToggleButton
 										>
diff --git a/frontend/src/lib/components/InviteUser.svelte b/frontend/src/lib/components/InviteUser.svelte
index 5c43fd7185..f489788d76 100644
--- a/frontend/src/lib/components/InviteUser.svelte
+++ b/frontend/src/lib/components/InviteUser.svelte
@@ -66,15 +66,17 @@
 		<ToggleButton position="left" value="operator" size="sm"
 			>Operator <Tooltip
 				>An operator can only execute and view scripts/flows/apps from your workspace, and only
-				those that he has visibility on</Tooltip
+				those that he has visibility on.</Tooltip
 			></ToggleButton
 		>
 		<ToggleButton position="center" value="author" size="sm"
 			>Author <Tooltip
-				>An Author can execute and view scripts/flows/apps, but he can also create new ones</Tooltip
+				>An Author can execute and view scripts/flows/apps, but he can also create new ones.</Tooltip
 			></ToggleButton
 		>
-		<ToggleButton position="right" value="admin" size="sm">Admin</ToggleButton>
+		<ToggleButton position="right" value="admin" size="sm">Admin<Tooltip
+			>An admin has full control over a specific Windmill workspace, including the ability to manage users, edit entities, and control permissions within the workspace.</Tooltip
+		></ToggleButton>
 	</ToggleButtonGroup>
 	<Button
 		variant="contained"
diff --git a/frontend/src/routes/(root)/(logged)/audit_logs/+page.svelte b/frontend/src/routes/(root)/(logged)/audit_logs/+page.svelte
index b2b55bbdd5..dd165034ef 100644
--- a/frontend/src/routes/(root)/(logged)/audit_logs/+page.svelte
+++ b/frontend/src/routes/(root)/(logged)/audit_logs/+page.svelte
@@ -84,6 +84,7 @@
 	<PageHeader
 		title="Audit logs"
 		tooltip="You can only see your own audit logs unless you are an admin."
+		documentationLink="https://www.windmill.dev/docs/core_concepts/audit_logs"
 	/>
 
 	{#if !$enterpriseLicense}
diff --git a/frontend/src/routes/(root)/(logged)/workspace_settings/+page.svelte b/frontend/src/routes/(root)/(logged)/workspace_settings/+page.svelte
index 06e711155e..c860904718 100644
--- a/frontend/src/routes/(root)/(logged)/workspace_settings/+page.svelte
+++ b/frontend/src/routes/(root)/(logged)/workspace_settings/+page.svelte
@@ -308,7 +308,11 @@
 			</Tabs>
 		</div>
 		{#if tab == 'users'}
-			<PageHeader title="Members ({users?.length ?? ''})" primary={false} />
+			<PageHeader
+				title="Members ({users?.length ?? ''})"
+				primary={false}
+				tooltip="Manage users manually or enable SSO authentication."
+				documentationLink="https://www.windmill.dev/docs/core_concepts/authentification"/>
 
 			<AddUser on:new={listUsers} />
 
@@ -375,16 +379,19 @@
 												<ToggleButton position="left" value="operator" size="xs"
 													>Operator <Tooltip
 														>An operator can only execute and view scripts/flows/apps from your
-														workspace, and only those that he has visibility on</Tooltip
+														workspace, and only those that he has visibility on.</Tooltip
 													></ToggleButton
 												>
 												<ToggleButton position="center" value="author" size="xs"
 													>Author <Tooltip
 														>An Author can execute and view scripts/flows/apps, but he can also
-														create new ones</Tooltip
+														create new ones.</Tooltip
 													></ToggleButton
 												>
-												<ToggleButton position="right" value="admin" size="xs">Admin</ToggleButton>
+												<ToggleButton position="right" value="admin" size="xs">Admin<Tooltip
+														>An admin has full control over a specific Windmill workspace, including the ability to manage users, edit
+														entities, and control permissions within the workspace.</Tooltip
+													></ToggleButton>
 											</ToggleButtonGroup>
 										</div>
 									</td>
@@ -440,7 +447,7 @@
 					</tbody>
 				</TableCustom>
 			</div>
-			<PageHeader title="Pending Invites ({invites.length ?? ''})" primary={false}>
+			<PageHeader title="Invites ({invites.length ?? ''})" primary={false} tooltip="Manage invites on your workspace." documentationLink="https://www.windmill.dev/docs/core_concepts/authentification#adding-users-to-a-workspace">
 				<InviteUser on:new={listInvites} />
 			</PageHeader>
 
@@ -481,7 +488,7 @@
 			</div>
 
 			<div class="mt-10" />
-			<PageHeader title="Auto Invite" primary={false} />
+			<PageHeader title="Auto Invite" tooltip="Auto invite to the workspace users from your domain." documentationLink="https://www.windmill.dev/docs/core_concepts/authentification#auto-invite" primary={false} />
 			<div class="flex gap-2">
 				{#if auto_invite_domain != domain}
 					<div>