move premium from heading to admonition

coder · EdwardAngert · Dec 17, 2024 · Dec 6, 2024 · Dec 10, 2024 · Dec 10, 2024
commit 0658f5acad55e36974dbe48f793779773ed182db
diff --git a/.vscode/markdown.code-snippets b/.vscode/markdown.code-snippets
@@ -20,6 +20,14 @@
 		"body": "![${TM_SELECTED_TEXT:${1:alt}}](${2:url})$0",
 		"description": "image"
 	},
+	"premium-feature": {
+		"prefix": "#premium-feature",
+		"body": [
+			"<blockquote class=\"admonition tip\">\n",
+			"${1:feature} ${2|is,are|} an Enterprise and Premium feature. [Learn more](https://coder.com/pricing#compare-plans).\n",
+			"</blockquote>"
+		]
+	},
 	"tabs": {
 		"prefix": "#tabs",
 		"body": [

diff --git a/docs/admin/external-auth.md b/docs/admin/external-auth.md
@@ -179,11 +179,16 @@ Optionally, you can request custom scopes:
 CODER_EXTERNAL_AUTH_0_SCOPES="repo:read repo:write write:gpg_key"
 ```
 
-## Multiple External Providers (enterprise) (premium)
+## Multiple External Providers
 
-Multiple providers are an Enterprise feature.
-[Learn more](https://coder.com/pricing#compare-plans). Below is an example
-configuration with multiple providers.
+<blockquote class="admonition tip">
+
+Multiple providers is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
+
+Below is an example configuration with multiple providers:
 
 ```env
 # Provider 1) github.com
@@ -204,7 +209,7 @@ CODER_EXTERNAL_AUTH_1_TOKEN_URL="https://github.example.com/login/oauth/access_t
 CODER_EXTERNAL_AUTH_1_VALIDATE_URL="https://github.example.com/api/v3/user"
 ```
 
-To support regex matching for paths (e.g. github\.com/org), you'll need to add
+To support regex matching for paths (e.g. `github\.com/org`), you'll need to add
 this to the
 [Coder agent startup script](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script):
 

diff --git a/docs/admin/monitoring/notifications/index.md b/docs/admin/monitoring/notifications/index.md
@@ -232,7 +232,14 @@ notification is indicated on the right hand side of this table.
 
 ![User Notification Preferences](../../../images/admin/monitoring/notifications/user-notification-preferences.png)
 
-## Delivery Preferences (enterprise) (premium)
+## Delivery Preferences
+
+<blockquote class="admonition tip">
+
+Delivery preferences is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Administrators can configure which delivery methods are used for each different
 [event type](#event-types).

diff --git a/docs/admin/networking/index.md b/docs/admin/networking/index.md
@@ -176,7 +176,14 @@ coder server, so they can only be geo-distributed with High Availability mode in
 our Premium Edition. [Reach out to Sales](https://coder.com/contact) to learn
 more.
 
-## Browser-only connections (enterprise) (premium)
+## Browser-only connections
+
+<blockquote class="admonition tip">
+
+Browser-only connections is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Some Coder deployments require that all access is through the browser to comply
 with security policies. In these cases, pass the `--browser-only` flag to
@@ -186,7 +193,14 @@ With browser-only connections, developers can only connect to their workspaces
 via the web terminal and
 [web IDEs](../../user-guides/workspace-access/web-ides.md).
 
-### Workspace Proxies (enterprise) (premium)
+### Workspace Proxies
+
+<blockquote class="admonition tip">
+
+Workspace proxies are an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Workspace proxies are a Coder Enterprise feature that allows you to provide
 low-latency browser experiences for geo-distributed teams.

diff --git a/docs/admin/networking/port-forwarding.md b/docs/admin/networking/port-forwarding.md
@@ -129,7 +129,14 @@ resource uses a different method of authentication and **is not impacted by the
 template's maximum sharing level**, nor the level of a shared port that points
 to the app.
 
-### Configure maximum port sharing level (enterprise) (premium)
+### Configure maximum port sharing level
+
+<blockquote class="admonition tip">
+
+Configuring port sharing level is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Premium-licensed template admins can control the maximum port sharing level for
 workspaces under a given template in the template settings. By default, the

diff --git a/docs/admin/templates/managing-templates/index.md b/docs/admin/templates/managing-templates/index.md
@@ -58,7 +58,14 @@ infrastructure, software, or security patches. Learn more about
 
 ![Updating a template](../../../images/templates/update.png)
 
-### Template update policies (enterprise) (premium)
+### Template update policies
+
+<blockquote class="admonition tip">
+
+Template update policies are an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Licensed template admins may want workspaces to always remain on the latest
 version of their parent template. To do so, enable **Template Update Policies**

diff --git a/docs/admin/templates/managing-templates/schedule.md b/docs/admin/templates/managing-templates/schedule.md
@@ -27,13 +27,27 @@ allow users to define their own autostart and autostop schedules. Admins can
 restrict the days of the week a workspace should automatically start to help
 manage infrastructure costs.
 
-## Failure cleanup (enterprise) (premium)
+## Failure cleanup
+
+<blockquote class="admonition tip">
+
+Failure cleanup is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Failure cleanup defines how long a workspace is permitted to remain in the
 failed state prior to being automatically stopped. Failure cleanup is only
 available for licensed customers.
 
-## Dormancy threshold (enterprise) (premium)
+## Dormancy threshold
+
+<blockquote class="admonition tip">
+
+Dormancy threshold is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Dormancy Threshold defines how long Coder allows a workspace to remain inactive
 before being moved into a dormant state. A workspace's inactivity is determined
@@ -43,13 +57,27 @@ the user before being accessible. Coder stops workspaces during their transition
 to the dormant state if they are detected to be running. Dormancy Threshold is
 only available for licensed customers.
 
-## Dormancy auto-deletion (enterprise) (premium)
+## Dormancy auto-deletion
+
+<blockquote class="admonition tip">
+
+Dormancy auto-deletion is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Dormancy Auto-Deletion allows a template admin to dictate how long a workspace
 is permitted to remain dormant before it is automatically deleted. Dormancy
 Auto-Deletion is only available for licensed customers.
 
-## Autostop requirement (enterprise) (premium)
+## Autostop requirement
+
+<blockquote class="admonition tip">
+
+Autostop requirement is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Autostop requirement is a template setting that determines how often workspaces
 using the template must automatically stop. Autostop requirement ignores any
@@ -79,7 +107,14 @@ Autostop requirement is disabled when the template is using the deprecated max
 lifetime feature. Templates can choose to use a max lifetime or an autostop
 requirement during the deprecation period, but only one can be used at a time.
 
-## User quiet hours (enterprise) (premium)
+## User quiet hours
+
+<blockquote class="admonition tip">
+
+User quiet hours are an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 User quiet hours can be configured in the user's schedule settings page.
 Workspaces on templates with an autostop requirement will only be forcibly

diff --git a/docs/admin/users/groups-roles.md b/docs/admin/users/groups-roles.md
@@ -31,7 +31,14 @@ Roles determine which actions users can take within the platform.
 A user may have one or more roles. All users have an implicit Member role that
 may use personal workspaces.
 
-## Custom Roles (Premium) (Beta)
+## Custom Roles
+
+<blockquote class="admonition tip">
+
+Custom roles are an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Starting in v2.16.0, Premium Coder deployments can configure custom roles on the
 [Organization](./organizations.md) level. You can create and assign custom roles

diff --git a/docs/admin/users/idp-sync.md b/docs/admin/users/idp-sync.md
@@ -184,7 +184,14 @@ Users who are not in a matching group will see the following error:
 
 ![Unauthorized group error](../../images/admin/group-allowlist.png)
 
-## Role sync (enterprise) (premium)
+## Role sync
+
+<blockquote class="admonition tip">
+
+Role sync is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 If your OpenID Connect provider supports roles claims, you can configure Coder
 to synchronize roles in your auth provider to roles within Coder.
@@ -302,7 +309,14 @@ Visit the Coder UI to confirm these changes:
 
 </div>
 
-## Organization Sync (Premium)
+## Organization Sync
+
+<blockquote class="admonition tip">
+
+Organization sync is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 > Note: In a future Coder release, this can be managed via the Coder UI instead
 > of server flags.

diff --git a/docs/admin/users/oidc-auth.md b/docs/admin/users/oidc-auth.md
@@ -130,7 +130,14 @@ your Coder deployment:
 CODER_DISABLE_PASSWORD_AUTH=true
 ```
 
-## SCIM (enterprise) (premium)
+## SCIM
+
+<blockquote class="admonition tip">
+
+SCIM is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Coder supports user provisioning and deprovisioning via SCIM 2.0 with header
 authentication. Upon deactivation, users are

diff --git a/docs/user-guides/workspace-management.md b/docs/user-guides/workspace-management.md
@@ -88,7 +88,14 @@ manually updated the workspace.
 
 ![Automatic Updates](../images/workspace-automatic-updates.png)
 
-## Bulk operations (enterprise) (premium)
+## Bulk operations
+
+<blockquote class="admonition tip">
+
+Bulk operations are an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Licensed admins may apply bulk operations (update, delete, start, stop) in the
 **Workspaces** tab. Select the workspaces you'd like to modify with the

diff --git a/docs/user-guides/workspace-scheduling.md b/docs/user-guides/workspace-scheduling.md
@@ -49,7 +49,14 @@ Workspaces will automatically shut down after a period of inactivity. This can
 be configured at the template level, but is visible in the autostop description
 for your workspace.
 
-## Autostop requirement (enterprise) (premium)
+## Autostop requirement
+
+<blockquote class="admonition tip">
+
+Autostop requirement is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Licensed template admins may enforce a required stop for workspaces to apply
 updates or undergo maintenance. These stops ignore any active connections or
@@ -61,7 +68,14 @@ and specified quiet hours (see below).
 > Admins: See the template schedule settings for more information on configuring
 > Autostop Requirement.
 
-### User quiet hours (enterprise) (premium)
+### User quiet hours
+
+<blockquote class="admonition tip">
+
+User quiet hours are an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 User quiet hours can be configured in the user's schedule settings page.
 Workspaces on templates with an autostop requirement will only be forcibly
@@ -99,7 +113,14 @@ Let's say that both are set to 5 hours. When either your workspace autostarts or
 you sign in, you will have confidence that the only condition for shutdown is 5
 hours of inactivity.
 
-## Dormancy (enterprise) (premium)
+## Dormancy
+
+<blockquote class="admonition tip">
+
+Dormancy is an Enterprise and Premium feature.
+[Learn more](https://coder.com/pricing#compare-plans).
+
+</blockquote>
 
 Dormancy automatically deletes workspaces which remain unused for long
 durations. Template admins configure an inactivity period after which your