From 630fa964172b49ef9079b14678255cc3ad5b4468 Mon Sep 17 00:00:00 2001
From: Benjamin Fan <ben-git@swinglonga.com>
Date: Mon, 19 May 2025 17:25:17 -0700
Subject: [PATCH] fix(dev:docs): Improve SVG signatures

---
 .../dev/docs/reference/api/svg/defs/readme.mdx  | 17 +++++++++++++++--
 .../dev/docs/reference/api/svg/style/readme.mdx | 11 +++++++++--
 2 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/sites/dev/docs/reference/api/svg/defs/readme.mdx b/sites/dev/docs/reference/api/svg/defs/readme.mdx
index 87a33ed4bde..0a8baff1f60 100644
--- a/sites/dev/docs/reference/api/svg/defs/readme.mdx
+++ b/sites/dev/docs/reference/api/svg/defs/readme.mdx
@@ -9,8 +9,21 @@ SVG document.
 
 ## Signature
 
-```svg
+```js
+Defs svg.defs = {
+  list = {
+    buttonhole: `<g id="buttonhole" transform="scale(1)">
+      <path class="mark" d="M -1,-5 L 1,-5 L 1,5 L -1,5 z"></path>
+    </g>`,
+  },
+}
+```
+
+Result:
+```
 <defs>
-  /* svg.defs will be inserted */
+  <g id="buttonhole" transform="scale(1)">
+    <path class="mark" d="M -1,-5 L 1,-5 L 1,5 L -1,5 z"></path>
+  </g>
 </defs>
 ```
diff --git a/sites/dev/docs/reference/api/svg/style/readme.mdx b/sites/dev/docs/reference/api/svg/style/readme.mdx
index 02a0a6348ab..0bd9fcfc0cf 100644
--- a/sites/dev/docs/reference/api/svg/style/readme.mdx
+++ b/sites/dev/docs/reference/api/svg/style/readme.mdx
@@ -7,9 +7,16 @@ section of the SVG document.
 
 ## Signature
 
-```svg
+```js
+String svg.style += 'circle {stroke:black;}'
+```
+
+Result:
+```
 <style type="text/css">
-  /* svg.style will be inserted */
+  circle {
+    stroke: black;
+  }
 </style>
 ```