Confirmed that each article in live TOC exists in PR's rendered TOC.
Objectives of this TOC redesign:
Removes abstract TOC buckets ("Fundamentals", "Advanced") and directly/immediately shows their content.
Avoid unnecessary levels of deep nesting, per IA & style guide (platform manual).
Uses more topical, specific TOC buckets, promoting the tech key words users are looking for, and a generally flatter design that reveals more articles and specific topics by default.
Enables more flexible grouping/placement of the articles.
Eliminates top-level buckets that are low-value & abstract; promotes the high-value, keyword-based nodes that were contained in them.
Eliminates a UX of guessing and having to explore into the abstract TOC nodes.
Makes maintenance/improvement easier.
Groups together articles such as distribution.md & versioning.md that were spread apart between two different TOC buckets (Fundamentals & Deployment).
Instead of mixing two different schemes for the TOC (group by tech topic vs. group by Fundamentals/Advanced), the new design uses only a single scheme: group by tech topic.
Within any topical TOC bucket, per industry convention, articles about basics/fundamentals are first, and advanced/specialized articles are below them.
Paragraph 1 in an article is an available place to tell user how to decide if article is relevant/required for them.
Mapping from existing TOC (left) to redesigned TOC (right):
This PR 3124 replaces forked July 2023 PR https://github.com/MicrosoftDocs/edge-developer/pull/2725, which lists the irrelevant file archive.md as entirely changed by that PR, yet not at all changed by that PR.
Rendered TOC for review: https://review.learn.microsoft.com/microsoft-edge/webview2/?branch=pr-en-us-3124 Before: https://learn.microsoft.com/microsoft-edge/webview2/
Confirmed that each article in live TOC exists in PR's rendered TOC.
Objectives of this TOC redesign:
This PR also makes the following changes:
Mapping from existing TOC (left) to redesigned TOC (right): This PR 3124 replaces forked July 2023 PR https://github.com/MicrosoftDocs/edge-developer/pull/2725, which lists the irrelevant file archive.md as entirely changed by that PR, yet not at all changed by that PR.
AB#50063950