Merge branch 'main' into user/mikehoffms/extension-samples

Author: mikehoffms

microsoft-edge/devtools-guide-chromium/evaluate-performance/selector-stats.md

@@ -153,6 +153,7 @@ Try to change your CSS selectors so they require less time to calculate, and mat
 <!-- ====================================================================== -->
 ## See also
 
+* [View CSS selector costs in the Performance tool sidebar](../whats-new/2024/11/devtools-131.md#view-css-selector-costs-in-the-performance-tool-sidebar) in _What's New in DevTools (Microsoft Edge 131)_.
 * [Introduction to the Performance tool](./index.md) - An introduction to analyzing runtime performance in DevTools.
 * [Performance features reference](./reference.md) - Covers many of the features in the **Performance** tool.
 * [The truth about CSS selector performance](https://blogs.windows.com/msedgedev/2023/01/17/the-truth-about-css-selector-performance/) - Windows blog post.

microsoft-edge/devtools-guide-chromium/whats-new/2024/11/devtools-131-images/themes-preferences.png

@@ -18,7 +18,12 @@ ms.date: 11/14/2024
 
 <!-- Subtitle: The Visual Studio Code themes are removed and themes will revert to the default themes: Light+ or Dark+.-->
 
-The Visual Studio Code themes feature is now deprecated.  These themes will revert to the **System preference** theme by default.  The **Light+** and **Dark+** themes continue to be supported.
+The Visual Studio Code themes feature is now deprecated.  These themes will revert to the **System preference** theme by default.  The **Light+** and **Dark+** themes continue to be supported.  To select a theme, select **Customize and control DevTools** > **Preferences** > **Theme** drop-down menu:
+
+![The Theme menu in DevTools Preferences](./devtools-131-images/themes-preferences.png)
+
+See also:
+* [Check for contrast issues with dark theme and light theme](../../../../devtools-guide-chromium/accessibility/test-dark-mode.md)
 
 
 <!-- ====================================================================== -->
@@ -33,6 +38,11 @@ Previously, the following experiments that were enabled by default couldn't be d
 
 This is now fixed, and you can disable these experiments.
 
+See also:
+* [Enable webhint](../../../experimental-features/index.md#enable-webhint) in _Experimental features in Microsoft Edge DevTools_.
+* [Show issues in Elements](../../../experimental-features/index.md#show-issues-in-elements) in _Experimental features in Microsoft Edge DevTools_.
+* [Open source files in Visual Studio Code](../../../experimental-features/index.md#open-source-files-in-visual-studio-code) in _Experimental features in Microsoft Edge DevTools_.
+
 
 <!-- ====================================================================== -->
 ## View CSS selector costs in the Performance tool sidebar
@@ -53,13 +63,23 @@ To view CSS selector costs:
 
 1. Click the **CSS Selector costs** button to expand its section.
 
+See also:
+* [Analyze CSS selector performance during Recalculate Style events](../../../evaluate-performance/selector-stats.md)
+
 
 <!-- ====================================================================== -->
-## Fixed edit field to exit after pressing tab after auto-completion
+## Fixed edit field to exit after pressing Tab after auto-completion
 
 <!-- Press Tab after choosing an autocomplete option to exit the field.-->
 
-Pressing **Tab** after auto-completion now exits the edit field and focuses on the next focus point.  Before, pressing **Tab** would just indent the text.
+<!-- todo: where in DevTools?  which tools? -->
+
+Pressing the **Tab** key after auto-completion now exits the edit field and focuses on the next focus point.  Before, pressing **Tab** would just indent the text.
+
+<!-- todo 
+See also:
+* []()
+-->
 
 
 <!-- ====================================================================== -->

microsoft-edge/devtools-guide-chromium/whats-new/2024/11/devtools-131.md

@@ -6,16 +6,14 @@ ms.author: msedgedevrel
 ms.topic: conceptual
 ms.service: microsoft-edge
 ms.subservice: extensions
-ms.date: 10/09/2023
+ms.date: 12/11/2024
 ---
 # Develop an extension for the Microsoft Edge sidebar
 
 As a Microsoft Edge extension developer, you can make your new or existing Microsoft Edge extension appear in the sidebar.  Any extension can use the sidebar in addition to its other UI.
 
 ![The sidebar for a Microsoft Edge extension](./sidebar-images/sidebar-screenshot.png)
 
-Note: The sidebar extensions feature is being rolled out to a growing user base for all channels of Microsoft Edge.<!-- todo: after rollout is complete, delete sentence -->
-
 By using the Sidebar API for extensions, you can enhance the browsing experience by enabling users to view additional information alongside the main content of a webpage.
 
 The _sidebar_ is a persistent pane located on the side of the browser, which coexists with the primary content of the browser.  The sidebar reduces the need to constantly switch between tabs, resulting in a more productive browsing experience.
@@ -38,7 +36,7 @@ Extensions can optionally use the sidebar API to show a custom UI in the Microso
 
 Features of the Sidebar API include:
 
-* The sidebar remains open while navigating between tabs.
+* The sidebar remains open while navigating between tabs.  Known issue: The sidebar is not automatically displayed again when the user switches to a tab in which the sidebar was previously open ([Issue #142](https://github.com/microsoft/MicrosoftEdge-Extensions/issues/142)).<!-- todo: update -->
 
 * An extension in the sidebar can be made available for specific websites.
 
@@ -153,6 +151,8 @@ chrome.tabs.onUpdated.addListener(async (tabId, info, tab) => {
 
 When a user switches to a tab or site for which the sidebar is not enabled, the sidebar is hidden.
 
+Known issue: The sidebar is not automatically displayed again when the user switches to a tab in which the sidebar was previously open ([Issue #142](https://github.com/microsoft/MicrosoftEdge-Extensions/issues/142)).<!-- todo: update -->
+
 For a complete example, see [Site-specific side panel example](https://github.com/GoogleChrome/chrome-extensions-samples/tree/main/functional-samples/cookbook.sidepanel-site-specific).
 
 
@@ -323,7 +323,7 @@ See [Types](https://developer.chrome.com/docs/extensions/reference/sidePanel/#ty
 <!-- ====================================================================== -->
 > [!NOTE]
 > Portions of this page are modifications based on work created and [shared by Google](https://developers.google.com/terms/site-policies) and used according to terms described in the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0).
-> The original page is found [here](https://developer.chrome.com/docs/extensions/reference/sidePanel/).
+> The original page is found [here](https://developer.chrome.com/docs/extensions/reference/api/sidePanel).
 
 [![Creative Commons License](../../media/cc-logo/88x31.png)](https://creativecommons.org/licenses/by/4.0)
 This work is licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0).

microsoft-edge/extensions-chromium/developer-guide/sidebar.md

@@ -6,7 +6,7 @@ ms.author: msedgedevrel
 ms.topic: conceptual
 ms.service: microsoft-edge
 ms.subservice: devtools
-ms.date: 09/24/2024
+ms.date: 12/12/2024
 ---
 # Use WebDriver to automate Microsoft Edge
 
@@ -281,7 +281,7 @@ You can pass an `EdgeOptions` object to the `EdgeDriver` constructor to configur
 
 ###### Choose Specific Browser Binaries
 
-You can start a WebDriver session with specific Microsoft Edge binaries.  For example, you can run tests using the [Microsoft Edge preview channels](https://www.microsoft.com/edge/download/insider), such as Microsoft Edge Beta, Dev, or Canary.
+You can start a WebDriver session with specific Microsoft Edge binaries.  For example, you can run tests using the [Microsoft Edge preview channels](https://www.microsoft.com/edge/download/insider), such as Microsoft Edge Beta, Dev, or Canary, as follows:
 
 ##### [C#](#tab/c-sharp)
 
@@ -328,13 +328,13 @@ let driver = edge.Driver.createSession(options);
 
 ###### Pass extra command-line arguments
 
-You can use `EdgeOptions` to configure command-line arguments that will be passed to the Microsoft Edge browser process when a session is created.  For example, you can configure the browser to run in headless mode.
+You can use `EdgeOptions` to configure command-line arguments that will be passed to the Microsoft Edge browser process when a session is created.  For example, you can configure the browser to run in headless mode, as follows:
 
 ##### [C#](#tab/c-sharp)
 
 ```csharp
 var options = new EdgeOptions();
-options.AddArgument("headless");
+options.AddArgument("--headless=new");
 
 var driver = new EdgeDriver(options);
 ```
@@ -346,7 +346,7 @@ from selenium import webdriver
 from selenium.webdriver.edge.options import Options
 
 options = Options()
-options.add_argument("headless")
+options.add_argument("--headless=new")
 
 driver = webdriver.Edge(options = options)
 ```
@@ -355,7 +355,7 @@ driver = webdriver.Edge(options = options)
 
 ```java
 EdgeOptions options = new EdgeOptions();
-options.addArguments("headless");
+options.addArguments("--headless=new");
 
 EdgeDriver driver = new EdgeDriver(options);
 ```
@@ -366,7 +366,7 @@ EdgeDriver driver = new EdgeDriver(options);
 const edge = require('selenium-webdriver/edge');
 
 let options = new edge.Options();
-options.addArguments("headless");
+options.addArguments("--headless=new");
 
 let driver = edge.Driver.createSession(options);
 ```