docs: small docs change + bundled schema formatting script (modelcontextprotocol#1078)

Co-authored-by: David Soria Parra <[email protected]>

Author: jesselumarie

CONTRIBUTING.md

@@ -70,6 +70,10 @@ npm run check:docs
 npm run format
 ```
 
+> [!NOTE]
+> You can run all schema/documentation
+> changes at once with `npm run prep:changes`.
+
 ## Blog changes
 
 The blog is built using [Hugo](https://gohugo.io/installation/) and located in the [`blog`](./blog) directory.
@@ -80,7 +84,7 @@ To preview blog changes locally:
 npm run serve:blog
 ```
 
-## Documentation Guidelines
+### Documentation Guidelines
 
 When contributing to the documentation:
 

package.json

@@ -22,17 +22,18 @@
   },
   "scripts": {
     "check": "npm run check:schema && npm run check:docs",
+    "check:docs": "npm run check:docs:format && npm run check:docs:links",
+    "check:docs:format": "prettier --check \"**/*.{md,mdx}\"",
+    "check:docs:links": "cd docs && npx mint broken-links",
     "check:schema": "npm run check:schema:ts && npm run check:schema:json && npm run check:schema:md",
     "check:schema:ts": "tsc --noEmit && eslint schema/ && prettier --check \"schema/**/*.ts\"",
     "check:schema:json": "tsx scripts/generate-schemas.ts --check",
     "check:schema:md": "for f in schema/*/schema.mdx; do typedoc --entryPoints \"${f%.mdx}.ts\" --schemaPageTemplate \"$f\" | cmp docs/specification/$(basename -- $(dirname -- \"$f\"))/schema.mdx - || exit 1; done",
-    "check:docs": "npm run check:docs:format && npm run check:docs:links",
-    "check:docs:format": "prettier --check \"**/*.{md,mdx}\"",
-    "check:docs:links": "cd docs && npx mint broken-links",
+    "format": "prettier --write \"**/*.{md,mdx}\" --ignore \"docs/specification/*/schema.mdx\" ",
     "generate:schema": "npm run generate:schema:json && npm run generate:schema:md",
     "generate:schema:json": "tsx scripts/generate-schemas.ts",
     "generate:schema:md": "for f in schema/*/schema.mdx; do typedoc --entryPoints \"${f%.mdx}.ts\" --schemaPageTemplate \"$f\" > docs/specification/$(basename -- $(dirname -- \"$f\"))/schema.mdx; done",
-    "format": "prettier --write \"**/*.{md,mdx}\" --ignore \"docs/specification/*/schema.mdx\" ",
+    "prep:changes": "npm run check:schema:ts && npm run generate:schema && npm run check:docs && npm run format",
     "serve:docs": "cd docs && npx mint dev",
     "serve:blog": "cd blog && hugo serve"
   },