Apply suggestions from review

Co-authored-by: Simeon Vincent <svincent@gmail.com> Co-authored-by: Rob Wu <rob@robwu.nl>
mdn · rebloor · May 23, 2025 · May 2, 2025 · May 2, 2025 · May 2, 2025
commit c581e686f6c4b1fd40c7eb4708fc308103eac999
@@ -21,7 +21,7 @@ Values of this type are a string and can take these values:
 - pink
 - purple
 - red
-- yello
+- yellow
 
 {{WebExtExamples("h2")}}
 

@@ -9,7 +9,7 @@ browser-compat: webextensions.api.tabGroups
 
 This API enables extensions to modify and rearrange [tab groups](https://support.mozilla.org/en-US/kb/tab-groups).
 
-Tab groups persist across browser restarts, except for tab groups in private browsing windows. When a tab group is restored, its tab group ID may differ from its original value.
+Tab groups may persist across browser restarts as part of session restore. Tab groups in private browsing windows do not persist across restarts. When a tab group is restored, its `groupId` may differ from its original value.
 
 The `tabGroups` API doesn't offer the ability to create or remove tab groups. Use the {{WebExtAPIRef("tabs.group()")}} and {{WebExtAPIRef("tabs.ungroup()")}} methods instead. To query the position of a tab group within a window, use {{WebExtAPIRef("tabs.query()")}}. These APIs in the `tabs` namespace don't require any permissions.
 
@@ -45,7 +45,7 @@ To use this API, an extension must request the `"tabGroups"` [permission](/en-US
 - {{WebExtAPIRef("tabGroups.onCreated")}}
   - : Fires when a tab group is created.
 - {{WebExtAPIRef("tabGroups.onMoved")}}
-  - : Fires when a tab group is moved, within a window or to another window.
+  - : Fires when a tab group is moved within a window or to another window.
 - {{WebExtAPIRef("tabGroups.onRemoved")}}
   - : Fires when a tab group is removed.
 - {{WebExtAPIRef("tabGroups.onUpdated")}}

@@ -7,9 +7,10 @@ browser-compat: webextensions.api.tabGroups.onMoved
 
 {{AddonSidebar}}
 
-Fires when a tab group is moved, within a window or to another window. {{WebExtAPIRef("tabs.onMoved")}} also fire for the tabs within the group.
+Fires when a tab group is moved within a window or to another window. {{WebExtAPIRef("tabs.onMoved")}} also fire for the tabs within the group.
 
 The event is passed a {{WebExtAPIRef("tabGroups.TabGroup")}} object. This includes the `windowId` but not the position of the tab group. To determine the position of the tab group, use {{WebExtAPIRef("tabs.query()")}} with the `groupId`, and read the `index` property of the returned tab.
+
 In Chrome, this event doesn't fire when a tab group is moved between windows; instead, the group is removed from one window and created in another (firing {{WebExtAPIRef("tabGroups.onRemoved")}} and {{WebExtAPIRef("tabGroups.onCreated")}}.
 
 ## Syntax

@@ -7,7 +7,9 @@ browser-compat: webextensions.api.tabGroups.onUpdated
 
 {{AddonSidebar}}
 
-Fires when a tab group is updated.
+Fires when a tab group's state changes. 
+
+This event does not fire when the group's membership changes or when a tab group is moved. Those updates are covered by {{WebExtAPIRef("tabs.onUpdated")}} and {{WebExtAPIRef("tabGroups.onMoved")}} respectively. 
 
 To detect `windowId` changes, use {{WebExtAPIRef("tabGroups.onMoved")}} instead.
 

@@ -1,8 +1,8 @@
 ---
-title: tabGroups.tabGroup
-slug: Mozilla/Add-ons/WebExtensions/API/tabGroups/tabGroup
+title: tabGroups.TabGroup
+slug: Mozilla/Add-ons/WebExtensions/API/tabGroups/TabGroup
 page-type: webextension-api-type
-browser-compat: webextensions.api.tabGroups.tabGroup
+browser-compat: webextensions.api.tabGroups.TabGroup
 ---
 
 {{AddonSidebar}}
-Original file line number
+Diff line change
@@ Expand Up / @@ -21,7 +21,7 @@ Values of this type are a string and can take these values: @@
     - pink
     - purple
     - red
-    - yello
+    - yellow
     {{WebExtExamples("h2")}}
@@ Expand Down @@