Update documentation for Premium license references

- Refine description to include "Premium" in feature availability. - Adjust terminology in auth and sync sections for consistency. - Modify organization documentation to reflect unified naming.
coder · stirby · Oct 1, 2024 · Sep 24, 2024 · Sep 24, 2024 · Sep 24, 2024
commit e100b557dc69c90bbabb5e4c96e5c003f170bf77
diff --git a/docs/admin/audit-logs.md b/docs/admin/audit-logs.md
@@ -122,5 +122,5 @@ entry:
 
 ## Enabling this feature
 
-This feature is only available with an
-[enterprise license](https://coder.com/pricing).
+This feature is only available with a
+[Premium or Enterprise license](https://coder.com/pricing).
diff --git a/docs/admin/auth.md b/docs/admin/auth.md
@@ -252,7 +252,7 @@ CODER_TLS_CLIENT_KEY_FILE=/path/to/key.pem
 If your OpenID Connect provider supports group claims, you can configure Coder
 to synchronize groups in your auth provider to groups within Coder. To enable
 group sync, ensure that the `groups` claim is being sent by your OpenID
-provider. This may involve requesting an additional
+provider. You might need to request an additional
 [scope](../reference/cli/server.md#--oidc-scopes) or additional configuration on
 the OpenID provider side.
 
@@ -266,8 +266,8 @@ There are two ways you can configure group sync:
 
 ## Server Flags
 
-First, confirm that your OIDC provider is sending a groups claim by logging in
-with OIDC and visiting the following URL:
+First, confirm that your OIDC provider is sending claims by logging in with OIDC
+and visiting the following URL with an `Owner` account:
 
 ```text
 https://[coder.example.com]/api/v2/debug/[your-username]/debug-link
@@ -437,14 +437,15 @@ Users who are not in a matching group will see the following error:
 If your OpenID Connect provider supports roles claims, you can configure Coder
 to synchronize roles in your auth provider to roles within Coder.
 
-There are two ways you can configure group sync:
+There are 2 ways to do role sync. Server Flags assign site wide roles, and
+runtime org role sync assigns organization roles
 
 <div class="tabs">
 
 ## Server Flags
 
 First, confirm that your OIDC provider is sending a roles claim by logging in
-with OIDC and visiting the following URL:
+with OIDC and visiting the following URL with an `Owner` account:
 
 ```text
 https://[coder.example.com]/api/v2/debug/[your-username]/debug-link
@@ -486,7 +487,7 @@ configure role sync at the organization level. In future Coder versions, you
 will be able to configure this in the UI. For now, you must use CLI commands.
 
 First, confirm that your OIDC provider is sending a roles claim by logging in
-with OIDC and visiting the following URL:
+with OIDC and visiting the following URL with an `Owner` account:
 
 ```text
 https://[coder.example.com]/api/v2/debug/[your-username]/debug-link
@@ -532,8 +533,8 @@ role.
 ```
 
 > Note: Be sure to use the `name` field for each role, not the display name. Use
-> `organization-admin`, `organization-user-admin`, `organization-auditor` for
-> the built in roles.
+> `coder organization  roles show --org=<your-org>` to see roles for your
+> organization.
 
 To set these role sync settings, use the following command:
 
@@ -551,11 +552,14 @@ Visit the Coder UI to confirm these changes:
 
 ## Organization Sync (Premium)
 
+> Note: In a future Coder release, this can be managed via the Coder UI instead
+> of server flags.
+
 If your OpenID Connect provider supports groups/role claims, you can configure
-Coder to synchronize roles in your auth provider to organizations within Coder.
+Coder to synchronize claims in your auth provider to organizations within Coder.
 
-First, confirm that your OIDC provider is sending a groups claim by logging in
-with OIDC and visiting the following URL:
+First, confirm that your OIDC provider is sending clainms by logging in with
+OIDC and visiting the following URL with an `Owner` account:
 
 ```text
 https://[coder.example.com]/api/v2/debug/[your-username]/debug-link

diff --git a/docs/admin/groups.md b/docs/admin/groups.md
@@ -9,5 +9,5 @@ access to specific templates. They can be defined via the Coder web UI,
 
 ## Enabling this feature
 
-This feature is only available with an
-[enterprise license](https://coder.com/pricing).
+This feature is only available with a
+[Premium or Enterprise license](https://coder.com/pricing).
diff --git a/docs/admin/organizations.md b/docs/admin/organizations.md
@@ -1,4 +1,4 @@
-# Organizations (Enterprise) (Premium)
+# Organizations (Premium)
 
 > Note: Organizations requires a [Premium license](../licensing.md). For more
 > details, [contact your account team](https://coder.com/contact).
@@ -15,7 +15,7 @@ with multiple platform teams, all with unique resources:
 
 ## The default organization
 
-All Coder deployments start with one organization called `Default`.
+All Coder deployments start with one organization called `Coder`.
 
 To edit the organization details, navigate to `Deployment -> Organizations` in
 the top bar:

diff --git a/docs/admin/rbac.md b/docs/admin/rbac.md
@@ -20,4 +20,4 @@ You can set the following permissions:
 ## Enabling this feature
 
 This feature is only available with an
-[enterprise license](https://coder.com/pricing).
+[Enterprise or Premium license](https://coder.com/pricing).
diff --git a/docs/images/admin/organizations/diagram.png b/docs/images/admin/organizations/diagram.png
diff --git a/docs/licensing.md b/docs/licensing.md
@@ -9,7 +9,7 @@ To try Premium features, you can [request a trial](https://coder.com/trial) or
 
 ## Adding your license key
 
-There are two ways to add an enterprise license to a Coder deployment:
+There are two ways to add a license to a Coder deployment:
 
 <div class="tabs">
 

diff --git a/site/src/pages/ManagementSettingsPage/IdpSyncPage/IdpSyncPageView.tsx b/site/src/pages/ManagementSettingsPage/IdpSyncPage/IdpSyncPageView.tsx
@@ -313,7 +313,7 @@ const IdpMappingTable: FC<IdpMappingTableProps> = ({
 												startIcon={<LaunchOutlined />}
 												component="a"
 												href={docs(
-													`/admin/auth#${type.toLowerCase()}-sync-enterprise`,
+													`/admin/auth#${type.toLowerCase()}-sync-enterprise-premium`,
 												)}
 												target="_blank"
 											>