From 42ef2154b4f3acdda7533c2593dd0cfc741f18f1 Mon Sep 17 00:00:00 2001
From: Tomas Zijdemans <tomas.zijdemans@vipps.no>
Date: Sun, 16 Aug 2026 14:56:22 +0200
Subject: [PATCH] docs: note markdown code fences are type-checked

---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 29e2ddc805b1..c956592ee1c1 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -93,6 +93,10 @@ Example snippets must be reproducible and use `@std/assert` assertions. Use
 `ignore` directive to skip running a snippet, `expect-error` for expected
 failures, `no-assert` to exempt a snippet from requiring assertions.
 
+`deno task test` (via `--doc`) also type-checks TypeScript code fences in
+markdown files such as README.md; mark snippets that cannot run in CI by tagging
+the fence `ts ignore` instead of `ts`.
+
 Module files (`mod.ts`) need a `@module` tag.
 
 ## Error Message Style