addresses review feedback

Author: dipikabh

files/en-us/web/webdriver/reference/bidi/modules/browser/createusercontext/index.md

@@ -29,6 +29,9 @@ Set `params` to an empty object (`{}`) or include any of the following optional
 - `unhandledPromptBehavior` {{optional_inline}}
   - : An object that specifies the default behavior when a user prompt (such as an `alert`, `confirm`, or `prompt` dialog) is encountered within this user context. When set, it overrides the [session-level](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/session/new#unhandledpromptbehavior) `unhandledPromptBehavior` setting for this user context.
 
+> [!NOTE]
+> When a parameter is set, it applies to all existing and future tabs within this user context.
+
 ### Return value
 
 The following field in the `result` object of the response describes the created user context:

files/en-us/web/webdriver/reference/bidi/modules/browser/index.md

@@ -7,29 +7,31 @@ browser-compat: webdriver.bidi.browser
 sidebar: webdriver
 ---
 
-The **`browser`** module contains commands for managing the browser, including user contexts, client windows, and download behavior.
+The **`browser`** module contains commands for managing the browser, including client windows, user contexts, and download behavior.
 
-## User contexts
+## Client windows
 
-A user context is a collection of zero or more top-level contexts (tabs) within the browser. Tabs within the same user context share the same browser storage (such as cookies and session data), while tabs in different user contexts are completely isolated from one another and do not share any browser data. A user context with no tabs is called an empty user context.
+A client window is an OS-level browser window, which includes the viewport (the area where web content is displayed) and browser UI elements such as the address bar and toolbars.
 
-Each user context has a unique string identifier (user context ID). The browser always has a default user context with the ID `"default"`, which cannot be removed.
+Each client window has the following properties:
 
-User contexts can be created using [`browser.createUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/createUserContext) and removed using [`browser.removeUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/removeUserContext).
+- A unique string identifier (`clientWindow`).
+- A state (`state`) indicating whether the window is normal, maximized, minimized, or fullscreen.
+- An active state (`active`) indicating whether the window can receive keyboard input from the operating system.
+- A position expressed as `x` and `y` coordinates in CSS pixels from the left and top edges of the screen, respectively.
+- A size expressed as `width` and `height` in CSS pixels.
 
-## Client windows
+A list of client windows can be obtained using [`browser.getClientWindows`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/getClientWindows) and their state can be changed using [`browser.setClientWindowState`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/setClientWindowState).
 
-A client window is a browser window, which includes the viewport (the area where web content is displayed) and browser UI elements such as the address bar and toolbars.
+## User contexts
 
-Each client window has the following properties:
+A user context is a collection of zero or more top-level contexts (tabs) within the browser. Tabs within the same user context share the same browser storage (such as cookies and session data), while tabs in different user contexts are completely isolated from one another and do not share any browser data. A user context with no tabs is called an empty user context.
 
-- A unique string identifier (client window ID)
-- A position expressed as `x` and `y` coordinates in CSS pixels from the left and top edges of the screen, respectively
-- A size expressed as `width` and `height` in CSS pixels
+Each user context has a unique string identifier (user context ID). The browser always has a default user context with the ID `"default"`, which cannot be removed.
 
-Multiple tabs from different [user contexts](#user_contexts) can share the same client window.
+Multiple tabs from different user contexts can share the same [client window](#client_windows).
 
-A list of client windows can be obtained using [`browser.getClientWindows`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/getClientWindows) and their state can be changed using [`browser.setClientWindowState`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/setClientWindowState).
+User contexts can be created using [`browser.createUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/createUserContext) and removed using [`browser.removeUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/removeUserContext).
 
 ## Commands
 

files/en-us/web/webdriver/reference/bidi/modules/browser/removeusercontext/index.md

@@ -7,7 +7,7 @@ browser-compat: webdriver.bidi.browser.removeUserContext
 sidebar: webdriver
 ---
 
-The `browser.removeUserContext` [command](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules#commands) of the [`browser`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser) module removes the specified [user context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser#user_contexts) and all its tabs across all windows. Tabs are closed without running [`beforeunload`](/en-US/docs/Web/API/Window/beforeunload_event) event handler functions.
+The `browser.removeUserContext` [command](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules#commands) of the [`browser`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser) module removes the specified [user context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser#user_contexts) and all its tabs across all windows. Tabs are closed without running the [`beforeunload`](/en-US/docs/Web/API/Window/beforeunload_event) event handler functions.
 
 > [!WARNING]
 > This command is irreversible, and all storage associated with the user context is permanently deleted.