Apply suggestions from code review

EdwardAngert · matifali · web-flow · commit 1735d16c3bf4 · 2025-03-10T15:05:42.000-04:00
Co-authored-by: M Atif Ali &lt;atif@coder.com&gt;
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
@@ -343,7 +343,7 @@ Breaking changes can be triggered in two ways:
 
 ### Security
 
-> [!IMPORTANT]
+> [!CAUTION]
 > If you find a vulnerability, **DO NOT FILE AN ISSUE**. Instead, send an email
 > to <security@coder.com>.
 
diff --git a/docs/admin/security/database-encryption.md b/docs/admin/security/database-encryption.md
@@ -118,8 +118,8 @@ data:
   This command will re-encrypt all tokens with the specified new encryption key.
   We recommend performing this action during a maintenance window.
 
-  > [!NOTE]
-  > this command requires direct access to the database. If you are using
+  > [!IMPORTANT]
+  > This command requires direct access to the database. If you are using
   > the built-in PostgreSQL database, you can run
   > [`coder server postgres-builtin-url`](../../reference/cli/server_postgres-builtin-url.md)
   > to get the connection URL.
diff --git a/docs/admin/security/index.md b/docs/admin/security/index.md
@@ -7,7 +7,7 @@ For other security tips, visit our guide to
 
 ## Security Advisories
 
-> [!IMPORTANT]
+> [!CAUTION]
 > If you discover a vulnerability in Coder, please do not hesitate to report it
 > to us by following the instructions
 > [here](https://github.com/coder/coder/blob/main/SECURITY.md).
diff --git a/docs/admin/users/github-auth.md b/docs/admin/users/github-auth.md
@@ -81,7 +81,7 @@ CODER_OAUTH2_GITHUB_CLIENT_ID="8d1...e05"
 CODER_OAUTH2_GITHUB_CLIENT_SECRET="57ebc9...02c24c"
 ```
 
-> [!NOTE]
+> [!TIP]
 > To allow everyone to sign up using GitHub, set:
 >
 > ```env
diff --git a/docs/admin/users/idp-sync.md b/docs/admin/users/idp-sync.md
@@ -107,7 +107,7 @@ Below is an example that uses the `groups` claim and maps all groups prefixed by
 }
 ```
 
-> [!NOTE]
+> [!IMPORTANT]
 > You must specify Coder group IDs instead of group names. The fastest way to find
 > the ID for a corresponding group is by visiting
 > `https://coder.example.com/api/v2/groups`.
diff --git a/docs/admin/users/password-auth.md b/docs/admin/users/password-auth.md
@@ -15,7 +15,7 @@ If you remove the admin user account (or forget the password), you can run the
 [`coder server create-admin-user`](../../reference/cli/server_create-admin-user.md)command
 on your server.
 
-> [!NOTE]
+> [!IMPORTANT]
 > You must run this command on the same machine running the Coder server.
 > If you are running Coder on Kubernetes, this means using
 > [kubectl exec](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_exec/)
diff --git a/docs/user-guides/workspace-access/index.md b/docs/user-guides/workspace-access/index.md
@@ -46,16 +46,15 @@ each user to simplify the setup process.
 
 1. Access Coder via SSH:
 
-   ```console
+   ```shell
    coder config-ssh
    ```
 
 1. Run `coder config-ssh --dry-run` if you'd like to see the changes that will be
    before you proceed:
 
-   ```bash
+   ```shell
    coder config-ssh --dry-run
-   ```
 
 1. Confirm that you want to continue by typing **yes** and pressing enter. If
 successful, you'll see the following message:

Original file line number	Diff line number	Diff line change
`@@ -81,7 +81,7 @@ CODER_OAUTH2_GITHUB_CLIENT_ID="8d1...e05"`
`81`	`81`	`CODER_OAUTH2_GITHUB_CLIENT_SECRET="57ebc9...02c24c"`
`82`	`82`	```
`83`	`83`
`84`		`-> [!NOTE]`
	`84`	`+> [!TIP]`
`85`	`85`	`> To allow everyone to sign up using GitHub, set:`
`86`	`86`	`>`
`87`	`87`	> ```env
Original file line number	Diff line number	Diff line change
@@ -107,7 +107,7 @@ Below is an example that uses the `groups` claim and maps all groups prefixed by
`107`	`107`	`}`
`108`	`108`	```
`109`	`109`
`110`		`-> [!NOTE]`
	`110`	`+> [!IMPORTANT]`
`111`	`111`	`> You must specify Coder group IDs instead of group names. The fastest way to find`
`112`	`112`	`> the ID for a corresponding group is by visiting`
`113`	`113`	> `https://coder.example.com/api/v2/groups`.