Multiple Redirection files #3487

mikehoffms · 2025-06-24T01:30:09Z

Rendered for review:

Navigate webpage layers, z-index, and DOM using the 3D View tool
- /devtools-guide-chromium/3d-view/index.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/devtools-guide-chromium/3d-view/index?branch=pr-en-us-3487
- External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/redir-files/microsoft-edge/devtools/3d-view/index.md
- Before/live: https://learn.microsoft.com/microsoft-edge/devtools-guide-chromium/3d-view/
- Replaced 1 long redirects file by a set of redirect files, per top-level TOC buckets.

Redirects to test before merge

Test strategy: test one redir per redir file.

1. .openpublishing.redirection.release-notes.json - empty

2. .openpublishing.redirection.experimental.json - empty

3. .openpublishing.redirection.devtools.json

"source_path": "../microsoft-edge/devtools-guide-chromium/whats-new/2025/06/devtools-137.md",
"redirect_url": "/microsoft-edge/devtools/whats-new/2025/06/devtools-137",

url to test:
https://review.learn.microsoft.com/microsoft-edge/devtools-guide-chromium/whats-new/2025/06/devtools-137?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/devtools/whats-new/2025/06/devtools-137?branch=pr-en-us-3487

4. .openpublishing.redirection.extensions.json

"source_path": "../microsoft-edge/extensions-chromium/getting-started/part2-content-scripts.md",
"redirect_url": "/microsoft-edge/extensions/getting-started/picture-inserter-content-script",

url to test:
https://review.learn.microsoft.com/microsoft-edge/extensions-chromium/getting-started/part2-content-scripts?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/extensions/getting-started/picture-inserter-content-script?branch=pr-en-us-3487

5. .openpublishing.redirection.pwa.json

      "source_path": "../microsoft-edge/progressive-web-apps-chromium/experimental-features/index.md",
      "redirect_url": "/microsoft-edge/origin-trials/index",

url to test:
https://review.learn.microsoft.com/microsoft-edge/progressive-web-apps-chromium/experimental-features/index?branch=pr-en-us-3487
https://review.learn.microsoft.com/microsoft-edge/progressive-web-apps-chromium/experimental-features/?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/origin-trials/?branch=pr-en-us-3487

6. .openpublishing.redirection.webview2.json

      "source_path": "../microsoft-edge/webview2/howto/js.md",
      "redirect_url": "/microsoft-edge/webview2/how-to/javascript",

url to test:
https://review.learn.microsoft.com/microsoft-edge/webview2/howto/js?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/webview2/how-to/javascript?branch=pr-en-us-3487

7. .openpublishing.redirection.test-automation.json - includes WebDriver

      "source_path": "../microsoft-edge/webdriver-chromium/ie-mode.md",
      "redirect_url": "/microsoft-edge/webdriver/ie-mode",

url to test:
https://review.learn.microsoft.com/microsoft-edge/webdriver-chromium/ie-mode?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/webdriver/ie-mode?branch=pr-en-us-3487

8. .openpublishing.redirection.web-dev-tips.json - /web-platform/

      "source_path": "../microsoft-edge/devtools-guide-chromium/json-viewer/json-viewer.md",
      "redirect_url": "/microsoft-edge/web-platform/json-viewer",

url to test:
https://review.learn.microsoft.com/microsoft-edge/devtools-guide-chromium/json-viewer/json-viewer?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/web-platform/json-viewer?branch=pr-en-us-3487

9. .openpublishing.redirection.ide-integration.json

      "source_path": "../microsoft-edge/visual-studio-code/elements-for-edge.md",
      "redirect_url": "/microsoft-edge/visual-studio-code/microsoft-edge-devtools-extension",

url to test:
https://review.learn.microsoft.com/microsoft-edge/visual-studio-code/elements-for-edge?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/microsoft-edge/visual-studio-code/microsoft-edge-devtools-extension?branch=pr-en-us-3487

10. .openpublishing.redirection.accessibility.json - empty

11. .openpublishing.redirection.dualengine.json - empty

12. .openpublishing.redirection.privacy.json - leaf node

      "source_path": "../microsoft-edge/privacy-whitepaper/index.md",
      "redirect_url": "https://learn.microsoft.com/legal/microsoft-edge/privacy",

url to test:
https://review.learn.microsoft.com/microsoft-edge/privacy-whitepaper/index?branch=pr-en-us-3487
https://review.learn.microsoft.com/microsoft-edge/privacy-whitepaper/?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/legal/microsoft-edge/privacy?branch=main&branchFallbackFrom=pr-en-us-3487

13. .openpublishing.redirection.archived.json - not in TOC

      "source_path": "../microsoft-edge/edgehtml/dev-guide/browser-features/reading-view.md",
      "redirect_url": "/archive/microsoft-edge/legacy/developer",

url to test:
https://review.learn.microsoft.com/microsoft-edge/edgehtml/dev-guide/browser-features/reading-view?branch=pr-en-us-3487
Status: OK
End up at: https://review.learn.microsoft.com/archive/microsoft-edge/legacy/developer/?branch=main&branchFallbackFrom=pr-en-us-3487

14. .openpublishing.redirection.mdn.json - not in TOC

      "source_path": "../microsoft-edge/dev-guide/css/filter-effects.md",
      "redirect_url": "https://developer.mozilla.org/docs/Web/CSS/filter",

url to test:
https://review.learn.microsoft.com/microsoft-edge/dev-guide/css/filter-effects?branch=pr-en-us-3487
Status: OK
End up at: https://developer.mozilla.org/docs/Web/CSS/filter

Redirects to test after merge

Status: OK

https://learn.microsoft.com/microsoft-edge/devtools-guide-chromium/whats-new/2025/06/devtools-137

https://learn.microsoft.com/microsoft-edge/extensions-chromium/getting-started/part2-content-scripts

https://learn.microsoft.com/microsoft-edge/progressive-web-apps-chromium/experimental-features/index
https://learn.microsoft.com/microsoft-edge/progressive-web-apps-chromium/experimental-features/

https://learn.microsoft.com/microsoft-edge/webview2/howto/js

https://learn.microsoft.com/microsoft-edge/webdriver-chromium/ie-mode

https://learn.microsoft.com/microsoft-edge/devtools-guide-chromium/json-viewer/json-viewer

https://learn.microsoft.com/microsoft-edge/visual-studio-code/elements-for-edge

https://learn.microsoft.com/microsoft-edge/privacy-whitepaper/index
https://learn.microsoft.com/microsoft-edge/privacy-whitepaper/

https://learn.microsoft.com/microsoft-edge/edgehtml/dev-guide/browser-features/reading-view

https://learn.microsoft.com/microsoft-edge/dev-guide/css/filter-effects

AB#58089678

captainbrosset

Thank you for the PR. I like having these redirects in multiple files a lot more than the giant file.

One question: is the counter (01, 02, .etc) in the filenames useful? If it represents the order of a given area in the current TOC, then we'll have to change it if we change the TOC. For example, if we decide that WebView2 should appear above Progressive Web Apps in the TOC, then we'll need to change two redirect file names.
I'm not the counters are helpful.

One suggestion: consider adding a README.md file inside the /redirects/ folder which explains how the files are organized, and why some of them are empty.

learn-build-service-prod · 2025-07-01T22:29:20Z

Learn Build status updates of commit 1994a6d:

✅ Validation status: passed

File	Status	Preview URL
.openpublishing.redirection.json	✅Succeeded	n/a (file deleted or renamed)
redirects/.openpublishing.redirection.accessibility.json	✅Succeeded
redirects/.openpublishing.redirection.archived.json	✅Succeeded	View
redirects/.openpublishing.redirection.devtools.json	✅Succeeded	View
redirects/.openpublishing.redirection.dualengine.json	✅Succeeded
redirects/.openpublishing.redirection.experimental.json	✅Succeeded
redirects/.openpublishing.redirection.extensions.json	✅Succeeded	View
redirects/.openpublishing.redirection.ide-integration.json	✅Succeeded	View
redirects/.openpublishing.redirection.mdn.json	✅Succeeded	View
redirects/.openpublishing.redirection.privacy.json	✅Succeeded	View
redirects/.openpublishing.redirection.pwa.json	✅Succeeded	View
redirects/.openpublishing.redirection.release-notes.json	✅Succeeded
redirects/.openpublishing.redirection.test-automation.json	✅Succeeded	View
redirects/.openpublishing.redirection.web-dev-tips.json	✅Succeeded	View
redirects/.openpublishing.redirection.webview2.json	✅Succeeded	View
redirects/Readme.txt	✅Succeeded

For more details, please refer to the build report.

captainbrosset

Looks good to me. I also confirm that redirects listed in the top level comment work as expected.

mikehoffms

LGTM - Writer/Editor

* multi redir files * redir dir * move redir dir * re-populate redir files from "main" * try 6 spaces before ] like main * move redir files to root * trim excess leading spaces * move devtools redir file into /redirects/ * move devtools redir file to root * move pwa redir * move redir files to dir, relative path * readme Co-authored-by: Michael Hoffman <[email protected]>

multi redir files

57e7235

mikehoffms added the cat: general General content. label Jun 24, 2025

mikehoffms changed the title ~~Multiple Redirection files eg .openpublishing.redirection.devtools.json~~ Multiple Redirection files, eg .openpublishing.redirection.devtools.json Jun 24, 2025

mikehoffms changed the title ~~Multiple Redirection files, eg .openpublishing.redirection.devtools.json~~ Multiple Redirection files Jun 24, 2025

mikehoffms added 2 commits June 24, 2025 09:59

Merge branch 'main' into user/mikehoffms/redir-files

8637d3d

redir dir

17bfbfa

MicrosoftDocs deleted a comment from learn-build-service-prod bot Jun 24, 2025

move redir dir

28fe70b

mikehoffms added the in-progress label Jun 27, 2025

mikehoffms marked this pull request as draft June 27, 2025 01:20

mikehoffms added 2 commits June 30, 2025 12:52

Merge branch 'main' into user/mikehoffms/redir-files

aba0fa6

re-populate redir files from "main"

bf16069

mikehoffms removed the in-progress label Jun 30, 2025

mikehoffms marked this pull request as ready for review June 30, 2025 21:03

mikehoffms added 5 commits June 30, 2025 14:12

try 6 spaces before ] like main

09fe981

move redir files to root

0d7315f

trim excess leading spaces

eab6695

move devtools redir file into /redirects/

803a3b8

move devtools redir file to root

c0cbf7d

MicrosoftDocs deleted a comment from learn-build-service-prod bot Jun 30, 2025

mikehoffms requested a review from captainbrosset June 30, 2025 22:07

move pwa redir

b859cee

move redir files to dir, relative path

6c71877

MicrosoftDocs deleted a comment from learn-build-service-prod bot Jun 30, 2025

captainbrosset requested changes Jul 1, 2025

View reviewed changes

readme

3606869

MicrosoftDocs deleted a comment from learn-build-service-prod bot Jul 1, 2025

mikehoffms requested a review from captainbrosset July 1, 2025 16:47

Merge branch 'main' into user/mikehoffms/redir-files

1994a6d

captainbrosset approved these changes Jul 2, 2025

View reviewed changes

MicrosoftDocs deleted a comment from learn-build-service-prod bot Jul 2, 2025

mikehoffms commented Jul 2, 2025

View reviewed changes

captainbrosset merged commit 120658a into main Jul 3, 2025
2 checks passed

captainbrosset deleted the user/mikehoffms/redir-files branch July 3, 2025 08:01

captainbrosset mentioned this pull request Jul 3, 2025

main to live - 7/3/25 #3497

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Multiple Redirection files #3487

Multiple Redirection files #3487

Uh oh!

mikehoffms commented Jun 24, 2025 •

edited

Loading

Uh oh!

captainbrosset left a comment

Uh oh!

learn-build-service-prod bot commented Jul 1, 2025

Uh oh!

captainbrosset left a comment

Uh oh!

mikehoffms left a comment

Uh oh!

Uh oh!

Uh oh!

Multiple Redirection files #3487

Multiple Redirection files #3487

Uh oh!

Conversation

mikehoffms commented Jun 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Redirects to test before merge

1. .openpublishing.redirection.release-notes.json - empty

2. .openpublishing.redirection.experimental.json - empty

3. .openpublishing.redirection.devtools.json

4. .openpublishing.redirection.extensions.json

5. .openpublishing.redirection.pwa.json

6. .openpublishing.redirection.webview2.json

7. .openpublishing.redirection.test-automation.json - includes WebDriver

8. .openpublishing.redirection.web-dev-tips.json - /web-platform/

9. .openpublishing.redirection.ide-integration.json

10. .openpublishing.redirection.accessibility.json - empty

11. .openpublishing.redirection.dualengine.json - empty

12. .openpublishing.redirection.privacy.json - leaf node

13. .openpublishing.redirection.archived.json - not in TOC

14. .openpublishing.redirection.mdn.json - not in TOC

Redirects to test after merge

Uh oh!

captainbrosset left a comment

Choose a reason for hiding this comment

Uh oh!

learn-build-service-prod bot commented Jul 1, 2025

✅ Validation status: passed

Uh oh!

captainbrosset left a comment

Choose a reason for hiding this comment

Uh oh!

mikehoffms left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

mikehoffms commented Jun 24, 2025 •

edited

Loading