From 05da5bc3c1401734f1197ba6a620e2ed4f1b30e1 Mon Sep 17 00:00:00 2001 From: Prajwal Chikkur Date: Mon, 21 Sep 2026 16:27:46 +0530 Subject: [PATCH] Use jsonc language tag for JSON examples containing comments Three code blocks are tagged ```json but contain comments, which JSON does not permit, so the examples cannot be parsed or copied as-is: - copilot/reference/hooks-reference.md uses a /* hook entries */ placeholder - copilot/how-tos/copilot-sdk/troubleshooting/mcp-debugging.md uses a leading // comment - copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md uses three trailing // comments Retag these fences as ```jsonc, matching the convention already used elsewhere in the content directory for JSON with comments (for example the dev container examples in codespaces/). The renderer registers 'jsonc' as an alias of 'json' in src/content-render/unified/processor.ts, so highlighting on docs.github.com is unchanged while the fences also render correctly on github.com. The comments are left in place; only the language tags change. --- .../how-tos/copilot-sdk/troubleshooting/mcp-debugging.md | 2 +- .../reference/copilot-usage-metrics/lines-of-code-metrics.md | 2 +- content/copilot/reference/hooks-reference.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/copilot/how-tos/copilot-sdk/troubleshooting/mcp-debugging.md b/content/copilot/how-tos/copilot-sdk/troubleshooting/mcp-debugging.md index 6c568d242305..7ad2678674d5 100644 --- a/content/copilot/how-tos/copilot-sdk/troubleshooting/mcp-debugging.md +++ b/content/copilot/how-tos/copilot-sdk/troubleshooting/mcp-debugging.md @@ -392,7 +392,7 @@ This provides a web UI to: Check your server supports the protocol version the SDK uses: -```json +```jsonc // In initialize response, check protocolVersion {"result":{"protocolVersion":"2024-11-05",...}} ``` diff --git a/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md b/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md index a77135f33297..2dded1ef9d14 100644 --- a/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md +++ b/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md @@ -67,7 +67,7 @@ Unlike completions or chat, {% data variables.copilot.copilot_agent_short %} doe Example output for agent-related LoC activity: -```json +```jsonc "totals_by_language_feature": [ { "language": "unknown", diff --git a/content/copilot/reference/hooks-reference.md b/content/copilot/reference/hooks-reference.md index a7a3acf7e112..41ce7af842d6 100644 --- a/content/copilot/reference/hooks-reference.md +++ b/content/copilot/reference/hooks-reference.md @@ -841,7 +841,7 @@ Use `disableAllHooks` when you want to keep your hook configuration on disk but Set `disableAllHooks` to `true` at the top level to skip every hook in the file without deleting it. -```json +```jsonc { "version": 1, "disableAllHooks": false,