From dee3952fba2a58a447b2f6324ba8e42264640ffc Mon Sep 17 00:00:00 2001
From: Nick Vigilante <nick.vigilante@coder.com>
Date: Fri, 14 Aug 2026 18:28:07 +0000
Subject: [PATCH] docs: fix broken .style/ link and lift details block out of
 list item

- documentation.md: the Vale style-guide link pointed at docs/.style/style-guide/,
  which is excluded from the published docs corpus, so the relative link 404s on
  the live site. Repoint it to an absolute github.com URL.
- monitoring.md: lift the "Possible client values" <details> block out of the list
  item so it renders as a top-level accordion, and restore the dropped blockquote
  continuation marker.
---
 docs/about/contributing/documentation.md |  2 +-
 docs/ai-coder/ai-gateway/monitoring.md   | 43 ++++++++++++------------
 2 files changed, 23 insertions(+), 22 deletions(-)

diff --git a/docs/about/contributing/documentation.md b/docs/about/contributing/documentation.md
index 7c49259052224..3009e6d2652bc 100644
--- a/docs/about/contributing/documentation.md
+++ b/docs/about/contributing/documentation.md
@@ -33,7 +33,7 @@ following third-party references:
 ## Tools
 
 This repository runs [Vale](https://vale.sh/) on `docs/` as part of CI to enforce prose style.
-The configuration is the repo-root `.vale.ini`, and the curated rule set is documented in [`docs/.style/style-guide/`](../../.style/style-guide/README.md).
+The configuration is the repo-root `.vale.ini`, and the curated rule set is documented in [`docs/.style/style-guide/`](https://github.com/coder/coder/tree/main/docs/.style/style-guide).
 Run the same checks locally with `make lint/prose`.
 Vale runs in advisory mode in this iteration: warnings surface as inline PR annotations, but they don't block the build.
 
diff --git a/docs/ai-coder/ai-gateway/monitoring.md b/docs/ai-coder/ai-gateway/monitoring.md
index da45b643ee0af..85ae33e66b79b 100644
--- a/docs/ai-coder/ai-gateway/monitoring.md
+++ b/docs/ai-coder/ai-gateway/monitoring.md
@@ -194,33 +194,34 @@ curl -X GET "https://coder.example.com/api/v2/ai-gateway/sessions" \
 
 Available query filters:
 
-- `client` - Filter by client name.
-  <details>
-  <summary>Possible <code>client</code> values</summary>
-
-  > [!NOTE]
-  > Client classification is done on best effort basis using the `User-Agent` header;
-  not all clients send these headers in an easily-identifiable manner.
-
-  - `Claude Code`
-  - `Codex`
-  - `Zed`
-  - `GitHub Copilot (VS Code)`
-  - `GitHub Copilot (CLI)`
-  - `Kilo Code`
-  - `Coder Agents`
-  - `Mux`
-  - `Cursor`
-  - `OpenCode`
-  - `Unknown`
-
-  </details><br>
+- `client` - Filter by client name. Possible values are listed below.
 - `initiator` - Filter by user ID or username
 - `provider` - Filter by AI provider (e.g., `openai`, `anthropic`)
 - `model` - Filter by model name
 - `started_after` - Filter sessions after a timestamp
 - `started_before` - Filter sessions before a timestamp
 
+<details>
+<summary>Possible <code>client</code> values</summary>
+
+> [!NOTE]
+> Client classification is done on best effort basis using the `User-Agent` header;
+> not all clients send these headers in an easily-identifiable manner.
+
+- `Claude Code`
+- `Codex`
+- `Zed`
+- `GitHub Copilot (VS Code)`
+- `GitHub Copilot (CLI)`
+- `Kilo Code`
+- `Coder Agents`
+- `Mux`
+- `Cursor`
+- `OpenCode`
+- `Unknown`
+
+</details>
+
 Refer to the [API documentation](../../reference/api/aigateway.md) for full details.
 
 ## Data retention