Skip to content

Commit b5d6605

Browse files
committed
incorp remaining cmts
1 parent 321bb18 commit b5d6605

File tree

10 files changed

+83
-68
lines changed

10 files changed

+83
-68
lines changed

microsoft-edge/devtools-guide-chromium/device-mode/dual-screen-and-foldables.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.date: 07/21/2023
1212

1313
You can emulate the following dual-screen and foldable devices in Microsoft Edge DevTools, using the Device Emulation feature of DevTools:
1414

15-
* Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404-->
15+
* Surface Duo
1616
* [Samsung Galaxy Fold](https://www.samsung.com/global/galaxy/galaxy-fold)
1717

1818
Emulate the devices and toggle between the following postures:
@@ -26,9 +26,9 @@ Emulate the devices and toggle between the following postures:
2626
<!-- ====================================================================== -->
2727
## Test on foldable and dual-screen devices
2828

29-
When you emulate the Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404--> in a dual-screen posture in Microsoft Edge, the seam (the space between the two screens) is drawn over your website or app.
29+
When you emulate the Surface Duo in a dual-screen posture in Microsoft Edge, the seam (the space between the two screens) is drawn over your website or app.
3030

31-
The emulated display matches the way your website (or app) renders in the [Microsoft Edge Android app](https://play.google.com/store/apps/details?id=com.microsoft.emmx) while running on Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404-->. You may have to update your website (or app) to display better along the seam. For more information about adapting your website (or app) to the seam, see [How to work with the seam](/dual-screen/introduction#how-to-work-with-the-seam).
31+
The emulated display matches the way your website (or app) renders in the [Microsoft Edge Android app](https://play.google.com/store/apps/details?id=com.microsoft.emmx) while running on Surface Duo. You may have to update your website (or app) to display better along the seam. For more information about adapting your website (or app) to the seam, see [How to work with the seam](/dual-screen/introduction#how-to-work-with-the-seam).
3232

3333
The [Device Toolbar](../device-mode/index.md#simulate-a-mobile-viewport) has additional features to help you test your website or app in multiple postures and orientations. Click **Rotate** (![Rotate](./dual-screen-and-foldables-images/rotate-dark-icon.png)) to rotate the viewport to landscape orientation. Combine the feature with **Span** (![Span](./dual-screen-and-foldables-images/span-dark-icon.png)) to toggle between single-screen or folded and dual-screen or unfolded postures. Together, the features allow you to test your website or app in all four possible postures and orientations.
3434

@@ -44,7 +44,7 @@ The **Experimental Web Platform features** (![ExperimentalApis](./dual-screen-an
4444
<!-- ---------- -->
4545
###### Pointer shaking or stuttering
4646

47-
When you use a [Microsoft Remote Desktop client](/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients) to connect to a remote PC and emulate the Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404--> or [Samsung Galaxy Fold](https://www.samsung.com/global/galaxy/galaxy-fold), the pointer may shake or stutter. If you run into the issue, contact the Microsoft Edge DevTools team.
47+
When you use a [Microsoft Remote Desktop client](/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients) to connect to a remote PC and emulate the Surface Duo or [Samsung Galaxy Fold](https://www.samsung.com/global/galaxy/galaxy-fold), the pointer may shake or stutter. If you run into the issue, contact the Microsoft Edge DevTools team.
4848

4949

5050
<!-- ====================================================================== -->
46 Bytes
Loading

microsoft-edge/devtools-guide-chromium/performance/overview.md

Lines changed: 50 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,15 @@ Use the **Performance** tool to analyze your website's performance. There are t
3232

3333
**Detailed contents:**
3434
* [Overview](#overview)
35+
36+
* [Open the Performance tool](#open-the-performance-tool)
37+
* [Using the Command Menu](#using-the-command-menu)
38+
3539
* [Local metrics for page interactions](#local-metrics-for-page-interactions)
3640
* [Recorded profile timeline](#recorded-profile-timeline)
3741
* [Switching to viewing local metrics or another profile](#switching-to-viewing-local-metrics-or-another-profile)
38-
* [Open the Performance tool](#open-the-performance-tool)
39-
* [Using the Command Menu](#using-the-command-menu)
42+
43+
4044
* [Monitor Core Web Vitals metrics](#monitor-core-web-vitals-metrics)
4145
* [Terminology](#terminology)
4246
* [Use the demo page](#use-the-demo-page)
@@ -61,46 +65,7 @@ The **Performance** tool displays local metrics for page interactions, and lets
6165

6266

6367
<!-- ------------------------------ -->
64-
#### Local metrics for page interactions
65-
66-
Use the **Performance** tool to view Core Web Vitals metrics in the initial, **Local metrics** view. The home page of the **Performance** tool shows **Local metrics**, which is performance metrics about the rendered webpage:
67-
68-
* Largest Contentful Paint (LCP) - How quickly the main content of the page loaded.
69-
* Cumulative Layout Shift (CLS) - A measure of the most recent unexpected page layout shift.
70-
* Interaction to Next Paint (INP) - The responsiveness of the most recent user interaction on the page.
71-
72-
When you initially open the **Performance** tool, Core Web Vitals metrics are displayed, in three cards in a **Local metrics** section:
73-
74-
![The Performance tool home page showing Local metrics](./overview-images/performance-tool-intro-home-page.png)<!-- do not reuse -->
75-
76-
77-
<!-- ------------------------------ -->
78-
#### Recorded profile timeline
79-
80-
Also use the **Performance** tool to view a recorded performance trace, including:
81-
* Record a performance profile.
82-
* Change capture settings.
83-
* Analyze a performance report. Shows information about the performance of the page over the period of time where the recording occurred, such as:
84-
* The user interactions that occurred during the recording.
85-
* The JavaScript code that ran.
86-
* The styling and layout operations that occurred.
87-
* Other performance metrics over time, such as network requests and layout shifts.
88-
89-
After you record a performance trace, the performance trace is displayed instead of **Local metrics**.
90-
91-
92-
<!-- ------------------------------ -->
93-
#### Switching to viewing local metrics or another profile
94-
95-
To switch to displaying the initial, **Local metrics** view, click the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon](./overview-images/house-icon.png)) button.
96-
97-
To switch to displaying a different opened recorded profile timeline, click the **Show recent timeline sessions** dropdown, to the right of the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon](./overview-images/house-icon.png)) button.
98-
99-
![The Performance tool displaying a recorded profile](./overview-images/performance-tool-intro-profile.png)<!-- do not reuse -->
100-
101-
102-
<!-- ====================================================================== -->
103-
## Open the Performance tool
68+
#### Open the Performance tool
10469
<!-- https://developer.chrome.com/docs/devtools/performance/overview#open_the_performance_panel -->
10570

10671
To open the **Performance** tool:
@@ -116,8 +81,8 @@ To open the **Performance** tool:
11681
If the ![Performance icon](./overview-images/performance-icon.png) **Performance** tool isn't shown in the **Activity Bar**, click the **More tools** (![The More tools icon](./overview-images/more-tools-icon.png)) button and then select the **Performance** tool.
11782

11883

119-
<!-- ------------------------------ -->
120-
#### Using the Command Menu
84+
<!-- ---------- -->
85+
###### Using the Command Menu
12186
<!-- added heading as separator, compared to upstream -->
12287

12388
To open the **Performance** tool by using the **Command Menu**:
@@ -142,12 +107,49 @@ To open the **Performance** tool by using the **Command Menu**:
142107
![Command Menu with 'performance' entered](./overview-images/command-menu-performance.png)
143108

144109

110+
<!-- ------------------------------ -->
111+
#### Local metrics for page interactions
112+
113+
Use the **Performance** tool to view Core Web Vitals metrics in the initial, **Local metrics** view. The home page of the **Performance** tool shows **Local metrics**, which is performance metrics about the rendered webpage:
114+
115+
* Largest Contentful Paint (LCP) - How quickly the main content of the page loaded.
116+
* Cumulative Layout Shift (CLS) - A measure of the most recent unexpected page layout shift.
117+
* Interaction to Next Paint (INP) - The responsiveness of the most recent user interaction on the page.
118+
119+
When you initially open the **Performance** tool, Core Web Vitals metrics are displayed, in three cards in a **Local metrics** section:
120+
121+
![The Performance tool home page showing Local metrics](./overview-images/performance-tool-intro-home-page.png)<!-- do not reuse -->
122+
123+
124+
<!-- ------------------------------ -->
125+
#### Recorded profile timeline
126+
127+
Also use the **Performance** tool to view a recorded performance trace, including:
128+
* Record a performance profile.
129+
* Change capture settings.
130+
* Analyze a performance report. Shows information about the performance of the page over the period of time where the recording occurred, such as:
131+
* The user interactions that occurred during the recording.
132+
* The JavaScript code that ran.
133+
* The styling and layout operations that occurred.
134+
* Other performance metrics over time, such as network requests and layout shifts.
135+
136+
After you record a performance trace, the performance trace is displayed instead of **Local metrics**.
137+
138+
139+
<!-- ------------------------------ -->
140+
#### Switching to viewing local metrics or another profile
141+
142+
To switch to displaying the initial, **Local metrics** view, click the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon](./overview-images/house-icon.png)) button.
143+
144+
To switch to displaying a different opened recorded profile timeline, click the **Show recent timeline sessions** dropdown, to the right of the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon](./overview-images/house-icon.png)) button.
145+
146+
![The Performance tool displaying a recorded profile](./overview-images/performance-tool-intro-profile.png)<!-- do not reuse -->
147+
148+
145149
<!-- ====================================================================== -->
146150
## Monitor Core Web Vitals metrics
147151
<!-- ## Observe Core Web Vitals live https://developer.chrome.com/docs/devtools/performance/overview#live-metrics -->
148152

149-
The [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo page is designed to load and handle interactions slowly on purpose, in order to illustrate how the LCP, CLS, and INP metrics can be used in the **Performance** tool to identify and fix performance issues.
150-
151153
Use the **Performance** tool to view Core Web Vitals metrics in the initial, **Local metrics** view. The home page of the **Performance** tool shows **Local metrics**, which are performance metrics about the rendered webpage:
152154

153155
* **Largest Contentful Paint (LCP)** - How quickly the main content of the page loaded.
@@ -175,6 +177,8 @@ To produce a **poor** or **needs improvement** metric on the **LCP**, **CLS**, a
175177

176178
1. Open a webpage, such as the [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo, in a new window or tab.
177179

180+
The [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo page is designed to load and handle interactions slowly on purpose, in order to illustrate how the LCP, CLS, and INP metrics can be used in the **Performance** tool to identify and fix performance issues.
181+
178182
1. Right-click the webpage and then select **Inspect**.
179183

180184
DevTools opens.
83 Bytes
Loading

microsoft-edge/devtools-guide-chromium/performance/reference.md

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ To learn how to interact with the paint information, see [View layers informatio
260260

261261
Once a performance trace is [recorded](#record-performance), you can [analyze](#analyze-a-performance-recording) it, and annotate it to share your findings.
262262

263-
To annotate a recording, open the **Annotations** tab in the **Performance** tool sidebar. If the sidebar is not visible, click **Show sidebar** (![The Show sidebar icon](./reference-images/show-sidebar-icon.png)).
263+
To annotate a recording, open the **Annotations** tab in the **Performance** tool sidebar. If the sidebar is not visible, click the **Show sidebar** (![The Show sidebar icon](./reference-images/show-sidebar-icon.png)) button.
264264

265265
The **Annotations** tab in the sidebar initially contains instructions about how to add annotations. After you create annotations, as shown below, the tab lists your existing annotations, and allows you to delete them.
266266

@@ -339,18 +339,29 @@ After you [record runtime performance](#record-runtime-performance) or [record l
339339

340340
<!-- ------------------------------ -->
341341
#### Get actionable insights
342-
343-
The **Performance** tool extracts actionable insights from the recorded performance data. These insights are ways in which you can improve the performance of your website. The insights are focused on:
344-
345-
* LCP and INP by subpart.
346-
* LCP request discovery.
347-
* Layout shift culprits.
348-
* Render blocking requests.
349-
* Third parties.
350-
* Image delivery.
351-
* Document request latency.
352-
* Viewport optimization for mobile.
353-
* CSS selector costs.
342+
<!-- https://developer.chrome.com/docs/devtools/performance/reference#insights -->
343+
344+
The **Performance** tool extracts actionable insights from the recorded performance data. These insights are ways in which you can improve the performance of your website. The insights include:
345+
346+
* INP by phase
347+
* LCP by phase
348+
* LCP request discovery
349+
* Layout shift culprits
350+
* Render blocking request
351+
* Network dependency tree
352+
* Improve image delivery
353+
* Document request latency
354+
* Font display
355+
* Optimize viewport for mobile
356+
* Optimize DOM size
357+
* 3rd parties
358+
* CSS selector costs
359+
* Forced reflow
360+
* Use efficient cache lifetimes
361+
362+
The insights are focused on improving the Core Web Vitals metrics and on optimizing how quickly the webpage loads and renders.
363+
364+
After you record a profile in the **Performance** tool, the **Insights** tab in the sidebar shows the list of actionable insights that apply to the recorded performance data. To view the list of insights that don't apply to the profile, see the **Passed insights** section.
354365

355366
To use the insights:
356367

@@ -360,8 +371,7 @@ To use the insights:
360371

361372
![Hovering over entries in the Insights tab ](./reference-images/insights-tab.png)
362373

363-
364-
To make the **Interactions** tab visible, click the **Move activity bar to the left** (![The "Move activity bar to the left" icon](./reference-images/move-activity-bar-to-the-left-icon.png)) button.<!-- added in Edge doc -->
374+
If the sidebar and **Insights** tab is not visible, click the **Show sidebar** (![The Show sidebar icon](./reference-images/show-sidebar-icon.png)) button.
365375

366376

367377
<!-- ------------------------------ -->

microsoft-edge/devtools-guide-chromium/remote-debugging/surface-duo-emulator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.date: 03/25/2021
1010
---
1111
# Remotely debug Surface Duo emulators
1212

13-
In this article, you walk through the process of remotely debugging your web content in the [Microsoft Edge app](https://play.google.com/store/apps/details?id=com.microsoft.emmx) on a Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404--> emulator from a desktop instance of [Microsoft Edge](https://www.microsoft.com/edge). For information on debugging on a Surface Duo device, follow our guide for [remote debugging Android devices](index.md).
13+
In this article, you walk through the process of remotely debugging your web content in the [Microsoft Edge app](https://play.google.com/store/apps/details?id=com.microsoft.emmx) on a Surface Duo emulator from a desktop instance of [Microsoft Edge](https://www.microsoft.com/edge). For information on debugging on a Surface Duo device, follow our guide for [remote debugging Android devices](index.md).
1414

1515

1616
<!-- ====================================================================== -->

microsoft-edge/devtools-guide-chromium/sample-code/sample-code.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@ last sync'd April 16, 2024
5555
| Sluggish Animation | Used for [Analyze runtime performance (tutorial)](../performance/index.md). | [/devtools-performance-get-started/](https://github.com/MicrosoftEdge/Demos/tree/main/devtools-performance-get-started) | [Sluggish Animation](https://microsoftedge.github.io/Demos/devtools-performance-get-started/) |
5656
| postMessage Trace Events | Tests `postMessage` trace events in the **Performance** tool. Used for [View messages between windows, iframes, and dedicated workers](../performance/reference.md#view-messages-between-windows-iframes-and-dedicated-workers) in _Performance features reference_. | [/devtools-postmessage-perf-timeline/](https://github.com/MicrosoftEdge/Demos/tree/main/devtools-postmessage-perf-timeline) | [postMessage Trace Events demo](https://microsoftedge.github.io/Demos/devtools-postmessage-perf-timeline/) |
5757
| CSS :target pseudo-class | Used for [Support forcing the :target CSS state](../whats-new/2021/01/devtools.md#support-forcing-the-target-css-state). | [/devtools-target-pseudo/](https://github.com/MicrosoftEdge/Demos/tree/main/devtools-target-pseudo) | [CSS :target pseudo-class demo](https://microsoftedge.github.io/Demos/devtools-target-pseudo/) |
58+
| Exploring the universe | Webpage used to demo the [Monitor Core Web Vitals metrics](../performance/overview.md#monitor-core-web-vitals-metrics) section in the _Performance tool: Analyze your website's performance_ article. | [/exploring-the-universe/](https://github.com/MicrosoftEdge/Demos/tree/main/exploring-the-universe) | [Exploring the universe webpage](https://microsoftedge.github.io/Demos/exploring-the-universe/) |
5859
| Heap Snapshot Visualizer | Source code for the [Heap Snapshot Visualizer](https://microsoftedge.microsoft.com/addons/detail/heap-snapshot-visualizer/fceldlhognbemkgfacnffkdanocidgce) extension for DevTools. | [/heap-snapshot-visualizer/](https://github.com/MicrosoftEdge/Demos/tree/main/heap-snapshot-visualizer) | n/a |
5960
| JSON dummy data | Simple JSON files. Used for [View a JSON file or server response with formatting](../../web-platform/json-viewer.md). | [/json-dummy-data/](https://github.com/MicrosoftEdge/Demos/tree/main/json-dummy-data) | [JSON dummy data](https://microsoftedge.github.io/Demos/json-dummy-data/) |
6061
| Inspect Network Activity | Used for [Inspect network activity](../network/index.md). | [/network-tutorial/](https://github.com/MicrosoftEdge/Demos/tree/main/network-tutorial) | [Inspect Network Activity Demo](https://microsoftedge.github.io/Demos/network-tutorial/) |

microsoft-edge/devtools-guide-chromium/whats-new/2020/08/devtools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Chromium issue [#174309](https://crbug.com/174309)
4747
<!-- ------------------------------ -->
4848
#### Emulate Surface Duo and Samsung Galaxy Fold
4949

50-
You can now test the look and feel of your website or app on two new devices: Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404--> and [Samsung Galaxy Fold](https://www.samsung.com/us/mobile/galaxy-fold) in Microsoft Edge.
50+
You can now test the look and feel of your website or app on two new devices: Surface Duo and [Samsung Galaxy Fold](https://www.samsung.com/us/mobile/galaxy-fold) in Microsoft Edge.
5151

5252
To help enhance your website or app for the dual-screen and foldable devices, use the following features when [emulating the device](../../../device-mode/index.md):
5353

microsoft-edge/devtools-guide-chromium/whats-new/2021/01/devtools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,7 @@ See also:
193193

194194
Test the appearance of your website or app on the following devices in Microsoft Edge.
195195

196-
* Surface Duo<!--https://www.microsoft.com/surface/devices/surface-duo 404-->
196+
* Surface Duo
197197
* [Samsung Galaxy Fold](https://www.samsung.com/us/mobile/galaxy-fold)
198198

199199
To access the new CSS media screen-spanning feature and the `getWindowSegments` (now `visualViewport.segments`) JavaScript API, go to `edge://flags` and toggle the flag next to **Experimental Web Platform features**:<!-- present as of April 19, 2022: -->

0 commit comments

Comments
 (0)