Redesign wv2 RelNotes by mikehoffms · Pull Request #3862 · MicrosoftDocs/edge-developer

Michael Hoffman (mikehoffms) · 2026-07-17T19:52:50Z

Rendered articles for review:

Release notes for WebView2
- /webview2/release-notes/index.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/index?branch=pr-en-us-3862
- External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-redesign/microsoft-edge/webview2/release-notes/index.md
- Before/live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/
- Old title: Release notes for the WebView2 SDK
- Moved the detailed relnotes content to dedicated Runtime pages or dedicated SDK pages.
- Linked to new index.md page for Runtime & for SDK.
Release notes for the WebView2 Runtime
- /webview2/release-notes/runtime/index.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/runtime/index?branch=pr-en-us-3862
- External preview:
- Planned live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/runtime/
- New firstchild landing page.
- Moved the Runtime content that was in about.md to here.
Runtime 151 (Aug. 3, 2026)
- /webview2/release-notes/runtime/151.md - 76.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/runtime/151?branch=pr-en-us-3862
- External preview:
- Planned live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/runtime/151
- Moved Runtime-related content out from SDK articles for the same Runtime.
Release notes for WebView2 SDKs
- /webview2/release-notes/sdk/index.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/sdk/index?branch=pr-en-us-3862
- External preview:
- Planned live: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/sdk/
- New firstchild landing page.
- Moved the SDK content that was in about.md to here.
Prerelease SDK 1.0.4126-prerelease, for Runtime 151 (Jul. 7, 2026) & other release articles
- /webview2/release-notes/1.0.4126-prerelease.md & similar
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/sdk/1-0-4126-prerelease?branch=pr-en-us-3862
- External preview:
- Planned live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/sdk/1-0-4126-prerelease
- New, short, dedicated .md file.
- Linked from later phase to earlier phase.
  - eg https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/sdk/1-0-4022-49?branch=pr-en-us-3862#enable-background-processing-and-offline-support-webview2-worker-apis
  - In old releases, converted from list format to section headings (linkable anchors). Esp. where needed, to enable linking from later phase to earlier phase.
- Removed empty sections, such as "Promotions to Phase 2: There are no promotions to Phase 2."
- Loosened space in bugfix lists.
About release notes for the WebView2 SDK
- /webview2/release-notes/about.md
- Before/live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/about
- Deleted article.
- Defined redirect.
- Moved content to:
  - /webview2/release-notes/index.md
  - /webview2/release-notes/runtime/index.md
  - /webview2/release-notes/sdk/index.md

Incidental files

title > heading
- /developer/index.yml
- Internal preview:
- External preview:
- Before/live:
- Changelist:
title > heading
- /devtools/contact.md
- Internal preview:
- External preview:
- Before/live:
- Changelist:
title > heading
- /web-platform/release-notes/139.md - 152.md
- Internal preview:
- External preview:
- Before/live:
- Changelist:
title > heading
- /web-platform/release-notes/index.md
- Internal preview:
- External preview:
- Before/live:
- Changelist:
title > heading
- /webview2/concepts/overview-features-apis.md
- Internal preview:
- External preview:
- Before/live:
- Changelist:
title > heading
- /webview2/concepts/versioning.md
- Internal preview:
- External preview:
- Before/live:
- Changelist:
title > heading
- /webview2/how-to/webdriver.md
- Internal preview:
- External preview:
- Before/live:
- Changelist:

Redirects to test before merge

about.md

"source_path": "../microsoft-edge/webview2/release-notes/about.md",
"redirect_url": "/microsoft-edge/webview2/release-notes/index",

Redirect to test:
https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/about?branch=pr-en-us-3862
result: ok
end up at:
https://review.learn.microsoft.com/en-us/microsoft-edge/webview2/release-notes/?branch=pr-en-us-3862

archive.md

"source_path": "../microsoft-edge/webview2/release-notes/archive.md",
"redirect_url": "/microsoft-edge/webview2/release-notes/index",

Redirect to test:
https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/archive?branch=pr-en-us-3862
result: ok
end up at:
https://review.learn.microsoft.com/en-us/microsoft-edge/webview2/release-notes/?branch=pr-en-us-3862

Redirects to test after merge

Redirect to test:
https://learn.microsoft.com/microsoft-edge/webview2/release-notes/about
result: __
end up at: __

Redirect to test:
https://learn.microsoft.com/microsoft-edge/webview2/release-notes/archive
result: __
end up at: __

AB#63161919

Michael Hoffman (mikehoffms)

LGTM - Writer/Editor

Patrick Brosset (captainbrosset) · 2026-08-13T08:35:04Z

+See:
+* [Release notes for the WebView2 Runtime](./runtime/index.md)
+* [Release notes for WebView2 SDKs](./sdk/index.md)


These 2 links are the same as in the See also section that's now immediately below them. Feels like an unnecessary duplicate, because they are so close by.

Patrick Brosset (captainbrosset) · 2026-08-13T08:39:22Z

+# Preview Runtime 152 (Aug. 3, 2026)
+
+Release notes for Microsoft Edge WebView2 Preview Runtime 152, release date: Aug. 3, 2026.
+
+This is a Preview Runtime, for early testing.  Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime.  See [Prerelease testing using preview channels](../../how-to/prerelease-testing.md).


This is a great intro for the preview runtime release note. Should we add a hidden comment for us to remember changing this intro when the runtime becomes stable?

Something like:

Suggested change

# Preview Runtime 152 (Aug. 3, 2026)

Release notes for Microsoft Edge WebView2 Preview Runtime 152, release date: Aug. 3, 2026.

This is a Preview Runtime, for early testing. Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels](../../how-to/prerelease-testing.md).



# Preview Runtime 152 (Aug. 3, 2026)



Release notes for Microsoft Edge WebView2 Preview Runtime 152, release date: Aug. 3, 2026.



This is a Preview Runtime, for early testing. Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels](../../how-to/prerelease-testing.md).

Done in commit 71e6b0f

Patrick Brosset (captainbrosset) · 2026-08-13T08:43:02Z

@@ -0,0 +1,44 @@
+---
+title: Preview Runtime 152 (Aug. 3, 2026)


The WebView2 team works with more specific version numbers than the 3-digits versions we've been using in this prototype PR.

So instead of "Runtime 152", it will be something like "Runtime 152.0.1234.12".
That's ok, we should just use their numbers, but I suggest keeping the file name as 152.md without the other numbers, because we'll be editing this file for preview and stable releases (which can have different numbers).

Done in commit 36dc1ca

Patrick Brosset (captainbrosset) · 2026-08-13T08:45:22Z

+<!-- ====================================================================== -->
+## Preview Runtime 151 (Jul. 7, 2026)
+
+Release notes for Microsoft Edge WebView2 Preview Runtime 151, release date: Jul. 7, 2026.
+
+Runtime 151 (Aug. 3, 2026) includes these changes.


I don't think this is needed, contrary to what we had previously discussed in our last meeting. Once a runtime becomes stable (no longer preview), you don't need to know what got shipped during the preview timeframe vs. the stable timeframe. You just want to see it all listed.

So, once a Runtime becomes stable, we remove the "preview" wording from its release note.

Done in commit 71e6b0f

Patrick Brosset (captainbrosset) · 2026-08-13T08:46:11Z

+<!-- ------------------------------ -->
+#### Bug fixes in the Preview Runtime


Similar comment here, a stable runtime release note should contain a single Bug fixes section, containing both the bug fixes that shipped with preview, and the ones that shipped with stable.

Done in commit 71e6b0f

Patrick Brosset (captainbrosset) · 2026-08-13T08:47:17Z

+<!-- ====================================================================== -->
+## Preview Runtime 150 (Jun. 11, 2026)
+
+Release notes for Microsoft Edge WebView2 Preview Runtime 150, release date: Jun. 11, 2026.
+
+Runtime 150 (Jul. 7, 2026) includes these changes.


Same comments as in 151.md (applies globally): this is no longer needed. Once a runtime is stable, its release note contains all changes, bug fixes, features, as consolidated lists.

Done in commit 71e6b0f

…ser/mikehoffms/wv2-relnotes-redesign

learn-build-service-prod · 2026-08-13T12:08:02Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-08-13T12:09:48Z

Learn Build status updates of commit 36dc1ca:

✅ Validation status: passed

File	Status	Preview URL
microsoft-edge/develop-web-microsoft-edge.md	✅Succeeded	View
microsoft-edge/developer/index.yml	✅Succeeded	View
microsoft-edge/devtools/contact.md	✅Succeeded	View
microsoft-edge/index.yml	✅Succeeded	View
microsoft-edge/toc.yml	✅Succeeded	View
microsoft-edge/web-platform/release-notes/139.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/140.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/141.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/142.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/143.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/144.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/145.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/146.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/147.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/148.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/149.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/150.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/151.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/152.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/index.md	✅Succeeded	View
microsoft-edge/webview2/concepts/overview-features-apis.md	✅Succeeded	View
microsoft-edge/webview2/concepts/versioning.md	✅Succeeded	View
microsoft-edge/webview2/how-to/prerelease-testing.md	✅Succeeded	View
microsoft-edge/webview2/how-to/self-hosting.md	✅Succeeded	View
microsoft-edge/webview2/how-to/set-preview-channel.md	✅Succeeded	View

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

middle of breaking up index/archive

374dd1c

Michael Hoffman (mikehoffms) added in-progress cat: webview2 WebView-related content. labels Jul 17, 2026

dissolve archive.md

14e6b01

Microsoft Docs (MicrosoftDocs) deleted a comment from learn-build-service-prod Bot Jul 18, 2026

redirects

0af7de7

Microsoft Docs (MicrosoftDocs) deleted a comment from learn-build-service-prod Bot Jul 18, 2026

Michael Hoffman (mikehoffms) added 2 commits July 18, 2026 11:01

3477-prerelease

cc99933

all files are in toc

c342643

Microsoft Docs (MicrosoftDocs) deleted a comment from learn-build-service-prod Bot Jul 18, 2026

Michael Hoffman (mikehoffms) added 10 commits July 18, 2026 11:34

from ~ to "title"

5e07094

more archive titles in toc

6035f18

x-link 3 phases (first impl'n)

57543f4

add parens: Phase 1 (Experimental in Prerelease)

df0ff04

link dragstarting to previous phase

5d12cc5

also link phase 2 to 1

749280c

promote std headings

d02dfe9

promote unique headings, missing headings

99b6744

resolve 8 titles in toc

ce86bec

toc finish titles, fill gap

6c75b1b

Microsoft Docs (MicrosoftDocs) deleted a comment from learn-build-service-prod Bot Jul 18, 2026

Michael Hoffman (mikehoffms) added 8 commits August 12, 2026 11:15

create runtime .md's

9b0c799

linkfix toc /sdk before 0-

4673312

linkfix since nested

a3feffc

more linkfix since nested

b69cbc4

final linkfixes since nested .md's

58d475c

x-link down thru 127

fc95cd6

fin x-links, & dates in toc

70a26b0

del local toc todo's

82cc50a

Michael Hoffman (mikehoffms) commented Aug 13, 2026

View reviewed changes

Michael Hoffman (mikehoffms) added 15 commits August 12, 2026 18:47

Runtime archive & SDK archive

79dfa42

polish toc cmts

ac36632

period on lead-in

d42f458

Runtime nnn (date) includes these changes

8dccdf9

fixed placement of x-link

f25d43d

Bug fixes in the Preview Runtime

ad10112

Preview Runtime

abc345b

WebView2 Preview Runtime

178a22a

accurate sdk link

dd011f6

more WebView2 Preview Runtime

53cbcd8

even more WebView2 Preview Runtime

1d28abb

just Archive

283ad92

.

bccd148

del local toc

6bf8662

add lead-in

48a47e1

Patrick Brosset (captainbrosset) requested changes Aug 13, 2026

View reviewed changes

Patrick Brosset (captainbrosset) added 3 commits August 13, 2026 10:48

Merge branch 'main' of github.com:MicrosoftDocs/edge-developer into u…

e096431

…ser/mikehoffms/wv2-relnotes-redesign

Consolidated stable runtime notes

71e6b0f

Add correct version numbers

36dc1ca

		@@ -0,0 +1,44 @@
		---
		title: Preview Runtime 152 (Aug. 3, 2026)

		<!-- ------------------------------ -->
		#### Bug fixes in the Preview Runtime

Uh oh!

Conversation

Michael Hoffman (mikehoffms) commented Jul 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Incidental files

Redirects to test before merge

about.md

archive.md

Redirects to test after merge

Uh oh!

Michael Hoffman (mikehoffms) left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

learn-build-service-prod Bot commented Aug 13, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Aug 13, 2026

✅ Validation status: passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Michael Hoffman (mikehoffms) commented Jul 17, 2026 •

edited

Loading