From 30eec4b8ca9755a3e41dfcb58a61540abbeb0ae0 Mon Sep 17 00:00:00 2001
From: Anthony Shew <anthonyshew@gmail.com>
Date: Mon, 19 Jan 2026 06:15:08 -0700
Subject: [PATCH] docs: Add update-versioned-schema-json codemod documentation

---
 .../content/docs/reference/turbo-codemod.mdx  | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/docs/site/content/docs/reference/turbo-codemod.mdx b/docs/site/content/docs/reference/turbo-codemod.mdx
index bd7447ec43cf7..458414f1dc5be 100644
--- a/docs/site/content/docs/reference/turbo-codemod.mdx
+++ b/docs/site/content/docs/reference/turbo-codemod.mdx
@@ -36,6 +36,25 @@ The codemods below are used for migration paths in the second major version of T
 
 <Accordions>
 
+<Accordion title="update-versioned-schema-json (2.7.5)" id="update-versioned-schema-json">
+
+Updates the `$schema` URL in `turbo.json` files to use the versioned subdomain format. This applies to both root and workspace `turbo.json` files.
+
+```bash title="Terminal"
+npx @turbo/codemod update-versioned-schema-json
+```
+
+**Example**
+
+```diff title="./turbo.json"
+{
+- "$schema": "https://turborepo.dev/schema.json",
++ "$schema": "https://v2-7-5.turborepo.dev/schema.json",
+}
+```
+
+</Accordion>
+
 <Accordion title="update-schema-json-url (2.0.0)" id="update-schema-json-url">
 
 Updates a versioned schema.json URL to v2.