From 96a3ebfe6dc2ecacd3eec8f2d0b290953c427f1d Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 3 Feb 2026 16:41:32 -0800
Subject: [PATCH 1/2] add example of disabled synchronization tabs

---
 components/tabs.mdx | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/components/tabs.mdx b/components/tabs.mdx
index 7d23547fd..1a0b7b6fe 100644
--- a/components/tabs.mdx
+++ b/components/tabs.mdx
@@ -54,13 +54,22 @@ Use tabs to organize content into multiple panels that users can switch between.
 </Tabs>
 ````
 
-Tabs automatically synchronize with other tabs and [code groups](/components/code-groups) on the same page when their labels match. When you select a tab, all other tabs and code groups with the same label update to match your selection. You can disable this behavior by setting `sync={false}`.
+Tabs automatically synchronize with other tabs and [code groups](/components/code-groups) on the same page when their labels match. When you select a tab, all other tabs and code groups with the same label update to match your selection.
 
-## Properties
+Add `sync={false}` to a `<Tabs>` component to disable synchronization.
 
-<ResponseField name="sync" type="boolean" default="true">
-  When `true`, tabs synchronize with other tabs and code groups on the page that have matching labels. Set to `false` to make tabs independent.
-</ResponseField>
+```mdx Disable synchronization example
+<Tabs sync={false}>
+  <Tab title="First tab">
+    This tab group operates independently.
+  </Tab>
+  <Tab title="Second tab">
+    Selecting tabs here won't affect other tab groups.
+  </Tab>
+</Tabs>
+```
+
+## Properties
 
 <ResponseField name="title" type="string" required>
   The title of the tab. Short titles are easier to navigate. Tabs with matching titles synchronize their selections.
@@ -74,6 +83,10 @@ Tabs automatically synchronize with other tabs and [code groups](/components/cod
   For Font Awesome icons only: One of `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
 </ResponseField>
 
+<ResponseField name="sync" type="boolean" default="true">
+  When `true`, tabs synchronize with other tabs and code groups on the page that have matching labels. Set to `false` to make tabs independent.
+</ResponseField>
+
 <ResponseField name="borderBottom" type="boolean">
   Adds a bottom border and padding to the tabs container. Useful to visually separate tabbed content from the rest of the page, especially when tabs contain content of varying lengths.
 </ResponseField>

From 68cd421835d6e709742b0b3b247a174ea318ca85 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 3 Feb 2026 16:45:03 -0800
Subject: [PATCH 2/2] copy edit

---
 components/tabs.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/tabs.mdx b/components/tabs.mdx
index 1a0b7b6fe..671d9ae1b 100644
--- a/components/tabs.mdx
+++ b/components/tabs.mdx
@@ -54,11 +54,11 @@ Use tabs to organize content into multiple panels that users can switch between.
 </Tabs>
 ````
 
-Tabs automatically synchronize with other tabs and [code groups](/components/code-groups) on the same page when their labels match. When you select a tab, all other tabs and code groups with the same label update to match your selection.
+Tabs with matching titles stay in sync across the page. For example, if you have multiple tab groups that include a `JavaScript` tab title, selecting `JavaScript` in one tab group automatically selects `JavaScript` in the others. This helps users who choose a language or framework once see that choice reflected everywhere. Tabs also sync with [code groups](/components/code-groups) that have matching titles.
 
-Add `sync={false}` to a `<Tabs>` component to disable synchronization.
+To disable tab synchronization, add `sync={false}` to a `<Tabs>` component.
 
-```mdx Disable synchronization example
+```mdx Disable tab sync example
 <Tabs sync={false}>
   <Tab title="First tab">
     This tab group operates independently.
@@ -84,7 +84,7 @@ Add `sync={false}` to a `<Tabs>` component to disable synchronization.
 </ResponseField>
 
 <ResponseField name="sync" type="boolean" default="true">
-  When `true`, tabs synchronize with other tabs and code groups on the page that have matching labels. Set to `false` to make tabs independent.
+  When `true`, tabs synchronize with other tabs and code groups on the page that have matching titles. Set to `false` to make tabs independent.
 </ResponseField>
 
 <ResponseField name="borderBottom" type="boolean">