diff --git a/docs/README.md b/docs/README.md
index a75e9321183..7f5651d787d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -4,3 +4,7 @@ The documentation in this folder are for management of the breadboard project,
 explaining how to [contribute](./contributing.md) and what the [code of conduct](./code-of-conduct.md) is.
 
 Documentation for how to create boards can be found on the [Breadboard website](https://breadboard-ai.github.io/breadboard/docs/)
+
+## New Syntax Documentation
+
+Learn about the new Breadboard syntax for defining boards with improved type safety and developer experience. See the [New Syntax Guide](./new-syntax-guide.md).
diff --git a/docs/updates.json b/docs/updates.json
index d861c8e5d5b..17921aa0e30 100644
--- a/docs/updates.json
+++ b/docs/updates.json
@@ -1,4 +1,9 @@
 [
+  {
+    "date": "2026-03-10",
+    "type": "info",
+    "text": "New Syntax Documentation Available: Comprehensive guide to the new Breadboard syntax featuring improved APIs for board definition, node configuration, and type safety"
+  },
   {
     "date": "2026-03-09",
     "type": "info",