fix(docs): add missing GFM alert directives to blockquotes (#19042)

aqandrew · web-flow · commit 72b8ab530ef2 · 2025-07-28T15:00:56.000-07:00
I just added support for rendering GFM alerts inside of numbered lists in coder.com (see coder/coder.com#328), and noticed that these plain blockquotes should probably be alerts. This should cover all the missing alerts. I found them by searching for the regex `^\s*>\s` within docs/**/*.md Is `[!NOTE]` the correct type for these? Or do we want to use tip/important/etc? - @mtojek CONTRIBUTING.md - @johnstcn support-bundle.md - @matifali gateway.md
diff --git a/docs/about/contributing/CONTRIBUTING.md b/docs/about/contributing/CONTRIBUTING.md
@@ -96,6 +96,7 @@ Use the following `make` commands and scripts in development:
 
    This should return an empty list of workspaces. If you encounter an error, review the output from the [develop.sh](https://github.com/coder/coder/blob/main/scripts/develop.sh) script for issues.
 
+   > [!NOTE]
    > `coder-dev.sh` is a helper script that behaves like the regular coder CLI, but uses the binary built from your local source and shares the same configuration directory set up by `develop.sh`. This ensures your local changes are reflected when testing.
    >
    > The default user is `admin@coder.com` and the default password is `SomeSecurePassword!`
diff --git a/docs/support/support-bundle.md b/docs/support/support-bundle.md
@@ -73,6 +73,7 @@ A brief overview of all files contained in the bundle is provided below:
    prompt. The support bundle will be generated in the current directory with
    the filename `coder-support-$TIMESTAMP.zip`.
 
+   > [!NOTE]
    > While support bundles can be generated without a running workspace, it is
    > recommended to specify one to maximize troubleshooting information.
 
diff --git a/docs/user-guides/workspace-access/jetbrains/gateway.md b/docs/user-guides/workspace-access/jetbrains/gateway.md
@@ -10,6 +10,7 @@ manually configured SSH connection.
 
 ### How to use the plugin
 
+> [!NOTE]
 > If you experience problems, please
 > [create a GitHub issue](https://github.com/coder/coder/issues) or share in
 > [our Discord channel](https://discord.gg/coder).

Original file line number	Diff line number	Diff line change
@@ -96,6 +96,7 @@ Use the following `make` commands and scripts in development:
`96`	`96`
`97`	`97`	`This should return an empty list of workspaces. If you encounter an error, review the output from the [develop.sh](https://github.com/coder/coder/blob/main/scripts/develop.sh) script for issues.`
`98`	`98`
	`99`	`+ > [!NOTE]`
`99`	`100`	> `coder-dev.sh` is a helper script that behaves like the regular coder CLI, but uses the binary built from your local source and shares the same configuration directory set up by `develop.sh`. This ensures your local changes are reflected when testing.
`100`	`101`	`>`
`101`	`102`	> The default user is `admin@coder.com` and the default password is `SomeSecurePassword!`