address review comments

aiven · Dec 13, 2024 · 420135f · 420135f
1 parent ebaccdf
commit 420135f
Show file tree

Hide file tree

Showing 3 changed files with 5 additions and 4 deletions.
diff --git a/docs/platform/concepts/permissions.md b/docs/platform/concepts/permissions.md
@@ -14,8 +14,9 @@ Principals are
 and [groups](/docs/platform/howto/manage-groups).
 
 You can grant access to principals at the organization and project level.
-You can
-[add users to services](/docs/platform/howto/create_new_service_user).
+
+To give users access to a specific service,
+[create service users](/docs/platform/howto/create_new_service_user).
 
 ## Organization roles and permissions
 

diff --git a/docs/platform/howto/make-super-admin.md b/docs/platform/howto/make-super-admin.md
@@ -4,7 +4,7 @@ title: Super admin
 
 import ConsoleLabel from "@site/src/components/ConsoleIcons"
 
-The super admin role is a special role that has unrestricted access to an organization and all of is resources. This role should be limited to as few users as possible for organization setup and emergency use. For daily administrative tasks, assign users the [organization admin role](/docs/platform/concepts/permissions) instead. Aiven also highly recommends enabling [two-factor authentication](/docs/platform/howto/user-2fa) for super admin.
+The super admin role is a special role that has unrestricted access to an organization and all of its resources. This role should be limited to as few users as possible for organization setup and emergency use. For daily administrative tasks, assign users the [organization admin role](/docs/platform/concepts/permissions) instead. Aiven also highly recommends enabling [two-factor authentication](/docs/platform/howto/user-2fa) for super admin.
 
 To make a user a super admin:
 

diff --git a/docs/platform/howto/manage-permissions.md b/docs/platform/howto/manage-permissions.md
@@ -5,7 +5,7 @@ title: Manage permissions
 import ConsoleLabel from "@site/src/components/ConsoleIcons"
 import {ConsoleIcon} from "@site/src/components/ConsoleIcons"
 
-You can grant [organzation users](/docs/platform/howto/manage-org-users), [application users](/docs/platform/concepts/application-users), and [groups](/docs/platform/howto/manage-groups) access at the organization and project level through [roles and permissions](/docs/platform/concepts/permissions).
+You can grant [organization users](/docs/platform/howto/manage-org-users), [application users](/docs/platform/concepts/application-users), and [groups](/docs/platform/howto/manage-groups) access at the organization and project level through [roles and permissions](/docs/platform/concepts/permissions).
 
 :::important
 When you remove permissions from a user or group, service credentials are not changed.