links instead of service-workers.md, web-app-manifests.md

Author: mikehoffms

microsoft-edge/developer/index.yml

@@ -143,11 +143,11 @@ landingContent:
 
       - linkListType: reference
         links:
-          - text: Service Worker API
-            url: https://developer.mozilla.org/docs/Web/API/Service_Worker_API
+          - text: Using Service Workers  # or "Service Worker API"
+            url: https://developer.mozilla.org/docs/Web/API/Service_Worker_API/Using_Service_Workers  # or https://developer.mozilla.org/docs/Web/API/Service_Worker_API
 
-          - text: Web app manifests  # was local link: Use a web app manifest to integrate a PWA into the OS
-            url: https://developer.mozilla.org/docs/Web/Manifest
+          - text: The web app manifest  # or "Web app manifests"
+            url: https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest  # or https://developer.mozilla.org/docs/Web/Manifest
 
 # =============================================================================
 # Card r2c2

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

@@ -127,7 +127,8 @@ To view errors and warnings in your Web App Manifest, select **Application** too
 For real-time updates on this feature in the Chromium open-source project, see Issue [1185945](https://crbug.com/1185945).
 
 See also:
-* [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN.
+* [The web app manifest](https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest) in _Making PWAs installable_ at MDN > References > Progressive web apps > Guides.
+* [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN > References.
 * [PWABuilder: Image Generator](https://www.pwabuilder.com/imageGenerator) - creates app icons for various platforms, to include in your Web App Manifest.
 
 

microsoft-edge/index.yml

@@ -260,12 +260,12 @@ conceptualContent:
               url: ./progressive-web-apps-chromium/how-to/offline.md
               itemType: how-to-guide
 
-            - text: Service Worker API
-              url: https://developer.mozilla.org/docs/Web/API/Service_Worker_API
+            - text: Using Service Workers  # or "Service Worker API"
+              url: https://developer.mozilla.org/docs/Web/API/Service_Worker_API/Using_Service_Workers  # or https://developer.mozilla.org/docs/Web/API/Service_Worker_API
               itemType: reference
 
-            - text: Web app manifests  # was local link: Use a web app manifest to integrate a PWA into the OS
-              url: https://developer.mozilla.org/docs/Web/Manifest
+            - text: The web app manifest  # or "Web app manifests"
+              url: https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest  # or https://developer.mozilla.org/docs/Web/Manifest
               itemType: reference
 
         # Card

microsoft-edge/progressive-web-apps-chromium/demo-pwas.md

@@ -18,7 +18,7 @@ Refer to these demo PWAs to learn how to use features and APIs that can progress
 
 PWAmp is a desktop music player that plays local and remote audio files.
 
-![Screenshot of the PWAmp app, showing playback buttons and a list of songs](./demo-pwas-images/pwamp.png)
+![The PWAmp app, showing playback buttons and a list of songs](./demo-pwas-images/pwamp.png)
 
 [App](https://microsoftedge.github.io/Demos/pwamp/), [source code and Readme file](https://github.com/MicrosoftEdge/Demos/tree/main/pwamp).
 
@@ -40,7 +40,7 @@ PWAmp uses the following features:
 
 Wami can apply a sequence of image manipulation steps such as cropping, resizing, rotating, or adding effects on batch of images.
 
-![Screenshot of the wami app](./demo-pwas-images/wami.png)
+![The wami app](./demo-pwas-images/wami.png)
 
 [App](https://microsoftedge.github.io/Demos/wami/), [source code and Readme file](https://github.com/MicrosoftEdge/Demos/tree/main/wami).
 

microsoft-edge/progressive-web-apps-chromium/how-to/best-practices.md

@@ -24,9 +24,9 @@ Your app can already be installed using the **App available** button in the brow
 
 A custom installation experience, in the app user interface, can be more obvious to your users and lead to more installations.
 
-To create a custom installation experience, use the [`beforeinstallprompt`](https://developer.mozilla.org/docs/Web/API/Window/beforeinstallprompt_event) event and provide your own installation button in your app.
+To create a custom installation experience, use the [beforeinstallprompt](https://developer.mozilla.org/docs/Web/API/Window/beforeinstallprompt_event) event and provide your own installation button in your app.
 
-To see a code example of the `beforeinstallprompt` event, check the [PWAmp demo app source code](https://github.com/MicrosoftEdge/Demos/blob/main/pwamp/app.js). To test the custom installation, open [PWAmp](https://microsoftedge.github.io/Demos/pwamp/), then click **More tools** (`...`) > **About** > **Install app** in the app.
+To see a code example of the `beforeinstallprompt` event, check the [PWAmp demo source code](https://github.com/MicrosoftEdge/Demos/blob/main/pwamp/app.js). To test the custom installation, open the [PWAmp demo](https://microsoftedge.github.io/Demos/pwamp/), and then click **More tools** (`...`) > **About** > **Install app** in the app.
 
 
 <!-- ====================================================================== -->
@@ -126,10 +126,11 @@ You can provide a good offline experience in several steps:
 1. Implement advanced scenarios such as letting users download data for offline viewing.
 
 See also:
+* [Synchronize and update a PWA in the background](./background-syncs.md).
+* [Using Service Workers](https://developer.mozilla.org/docs/Web/API/Service_Worker_API/Using_Service_Workers) at MDN > References > Web APIs > Service Worker API > Guides.
 * [Service Worker API](https://developer.mozilla.org/docs/Web/API/Service_Worker_API) at MDN > References > Web APIs.
 * [FetchEvent](https://developer.mozilla.org/docs/Web/API/FetchEvent) at MDN > References > Web APIs > Service Worker API.
 * [Cache](https://developer.mozilla.org/docs/Web/API/Cache) at MDN > References > Web APIs > Service Worker API.
-* [Synchronize and update a PWA in the background](./background-syncs.md).
 
 
 <!-- ====================================================================== -->
@@ -154,13 +155,13 @@ Installed apps typically perform advanced computing scenarios that websites usua
 
 To provide an app-like experience, use advanced web capabilities such as:
 
-* Hardware access with the [Web Bluetooth](https://developer.mozilla.org/docs/Web/API/Web_Bluetooth_API), [Web USB](https://developer.mozilla.org/docs/Web/API/USB), or [Web NFC](https://developer.mozilla.org/docs/Web/API/Web_NFC_API) APIs.
+* Hardware access with the [Web Bluetooth API](https://developer.mozilla.org/docs/Web/API/Web_Bluetooth_API), [USB](https://developer.mozilla.org/docs/Web/API/USB) (WebUSB API), or [Web NFC API](https://developer.mozilla.org/docs/Web/API/Web_NFC_API).
 * Clipboard access with the [Clipboard API](https://developer.mozilla.org/docs/Web/API/Clipboard_API).
 * Device contacts integration with the [Contact Picker API](https://developer.mozilla.org/docs/Web/API/Contact_Picker_API).
-* Rich media interactions with [Canvas](https://developer.mozilla.org/docs/Web/API/Canvas_API), [WebGL](https://developer.mozilla.org/docs/Web/API/WebGL_API), or [WebAudio](https://developer.mozilla.org/docs/Web/API/Web_Audio_API) APIs.
-* Safe and trusted authentication and payment with [WebAuthn](https://webauthn.guide/) and [Payment Request](https://developer.mozilla.org/docs/Web/API/Payment_Request_API) APIs.
+* Rich media interactions with the [Canvas API](https://developer.mozilla.org/docs/Web/API/Canvas_API), [WebGL: 2D and 3D graphics for the web](https://developer.mozilla.org/docs/Web/API/WebGL_API) (WebGL API), or [Web Audio API](https://developer.mozilla.org/docs/Web/API/Web_Audio_API).
+* Safe and trusted authentication and payment with the [WebAuthn API](https://webauthn.guide/) and [Payment Request API](https://developer.mozilla.org/docs/Web/API/Payment_Request_API).
 * Non-trivial computing tasks with [WebAssembly](https://developer.mozilla.org/docs/WebAssembly).
-* Reading and writing to files with the [File System Access API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API).
+* Reading and writing to files with the [File System API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API).
 
 Ensure your app's most important tasks can be done across all browsers and devices. See [Test on multiple browsers and devices](#test-on-multiple-browsers-and-devices).
 
@@ -177,11 +178,11 @@ To let your users achieve your app's most important tasks easily and in a famili
 * Use the `system-ui` font to make your content feel more native and load faster.
 * Use less links, and prefer bigger hit targets.
 * Support the operating system's light and dark themes by using the [prefers-color-scheme](https://developer.mozilla.org/docs/Web/CSS/@media/prefers-color-scheme) CSS media feature.
-* Provide a `background-color` and `theme-color` in your [web app manifest](https://developer.mozilla.org/docs/Web/Manifest) to customize the application window.
+* Provide a `background-color` and `theme-color` in your web app manifest to customize the application window.  See [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest).
 * Focus on the most important tasks, de-clutter de content, and streamline the user interface.
-* Re-organize the user interface based on the device's form factor, by using CSS [grid](https://developer.mozilla.org/docs/Web/CSS/CSS_Grid_Layout), [Flexbox](https://developer.mozilla.org/docs/Web/CSS/CSS_Flexible_Box_Layout), [Media queries](https://developer.mozilla.org/docs/Web/CSS/Media_Queries), and [Responsive images](https://developer.mozilla.org/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images).
+* Re-organize the user interface based on the device's form factor, by using [CSS grid layout](https://developer.mozilla.org/docs/Web/CSS/CSS_Grid_Layout), [CSS flexible box layout](https://developer.mozilla.org/docs/Web/CSS/CSS_Flexible_Box_Layout) (flexbox), [CSS media queries](https://developer.mozilla.org/docs/Web/CSS/Media_Queries), and [Responsive images](https://developer.mozilla.org/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images).
 * Improve perceived performance by registering user interactions immediately.
-* Consider using [skeleton screens](https://css-tricks.com/building-skeleton-screens-css-custom-properties/) if rendering the next screen takes time.
+* Consider using skeleton screens, if rendering the next screen takes time.  See [Building Skeleton Screens with CSS Custom Properties](https://css-tricks.com/building-skeleton-screens-css-custom-properties/).
 
 
 <!-- ====================================================================== -->
@@ -193,17 +194,17 @@ Make sure the most important scenarios of your app work everywhere, and progress
 
 To test your app in multiple environments, consider the following techniques:
 
-* [Cross-browser testing](https://developer.mozilla.org/docs/Learn/Tools_and_testing/Cross_browser_testing).
+* [Cross browser testing](https://developer.mozilla.org/docs/Learn/Tools_and_testing/Cross_browser_testing).
 * [Emulate and test other browsers](../../devtools-guide-chromium/device-mode/testing-other-browsers.md) from Microsoft Edge, by using DevTools.
 * Create a remote debugging session on [Windows](../../devtools-guide-chromium/remote-debugging/windows.md) or [Android](../../devtools-guide-chromium/remote-debugging/index.md).
 * [Test and automation in Microsoft Edge](../../test-and-automation/test-and-automation.md) to automate your testing.
-* Test on [virtual machines](https://developer.microsoft.com/microsoft-edge/tools/).
+* Test on [virtual machines](https://developer.microsoft.com/microsoft-edge/tools/).<!-- todo: redirects to https://developer.microsoft.com/en-us/microsoft-edge/tools/?cs=2233647189&form=MA13LH - vm not listed -->
 
 
 <!-- ====================================================================== -->
 ## Support deep linking
 
-To improve discovery and sharing of your app through the web and social media, route each page of your app to a unique URL and support [deep linking](https://wikipedia.org/wiki/Deep_linking).  
+To improve discovery and sharing of your app through the web and social media, route each page of your app to a unique URL and support [Deep linking](https://wikipedia.org/wiki/Deep_linking).  
 
 
 <!-- ======================================================================
@@ -214,5 +215,64 @@ TODO: Launch handler.
 
 
 <!-- ====================================================================== -->
-<!-- ## See also -->
-<!-- all links in article -->
+## See also
+
+Local: PWA:
+* [Define app shortcuts (long-press or right-click menus)](./shortcuts.md)
+* [Display a badge on the app icon](./notifications-badges.md#display-a-badge-on-the-app-icon) in _Re-engage users with badges, notifications, and push messages_.
+* [Display a PWA widget in the Windows Widgets Board](./widgets.md)
+* [Display content in the title bar area using Window Controls Overlay](./window-controls-overlay.md)
+* [Get started with PWAs](./index.md)
+* [Handle files in a PWA](./handle-files.md)
+* [Handle links to a PWA](./handle-urls.md)
+* [Handle protocols in a PWA](./handle-protocols.md)
+* [Icon image sizes](./icon-theme-color.md#icon-image-sizes) in _Define icons and a theme color_.
+* [Publish a PWA to the Microsoft Store](./microsoft-store.md)
+* [Share content with other apps](./share.md)
+* [Store data on the device](./offline.md)
+* [Synchronize and update a PWA in the background](./background-syncs.md)
+* [Test and automation in Microsoft Edge](../../test-and-automation/test-and-automation.md)
+
+Local: DevTools:
+* [Emulate and test other browsers](../../devtools-guide-chromium/device-mode/testing-other-browsers.md)
+* [Windows](../../devtools-guide-chromium/remote-debugging/windows.md)
+* [Android](../../devtools-guide-chromium/remote-debugging/index.md)
+
+MDN:
+* [beforeinstallprompt](https://developer.mozilla.org/docs/Web/API/Window/beforeinstallprompt_event) at MDN > References > Web APIs > Window.
+* [Cache](https://developer.mozilla.org/docs/Web/API/Cache) at MDN > References > Web APIs > Service Worker API.
+* [Canvas API](https://developer.mozilla.org/docs/Web/API/Canvas_API) at MDN > References > Web APIs.
+* [Clipboard API](https://developer.mozilla.org/docs/Web/API/Clipboard_API) at MDN > References > Web APIs.
+* [Contact Picker API](https://developer.mozilla.org/docs/Web/API/Contact_Picker_API) at MDN > References > Web APIs.
+* [Cross browser testing](https://developer.mozilla.org/docs/Learn/Tools_and_testing/Cross_browser_testing) at MDN > Guides > Tools and testing.
+* [display](https://developer.mozilla.org/docs/Web/Manifest/display) in MDN > References > Web app manifests > members.
+* [FetchEvent](https://developer.mozilla.org/docs/Web/API/FetchEvent) at MDN > References > Web APIs > Service Worker API.
+* [File System API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API) at MDN > References > Web APIs.
+* [CSS flexible box layout](https://developer.mozilla.org/docs/Web/CSS/CSS_Flexible_Box_Layout) (flexbox) at MDN > References > CSS.
+* [CSS grid layout](https://developer.mozilla.org/docs/Web/CSS/CSS_Grid_Layout) at MDN > References > CSS.
+* [CSS media queries](https://developer.mozilla.org/docs/Web/CSS/Media_Queries) at MDN > References > CSS.
+* [Payment Request API](https://developer.mozilla.org/docs/Web/API/Payment_Request_API) at MDN > REferences > Web APIs.
+* [prefers-color-scheme](https://developer.mozilla.org/docs/Web/CSS/@media/prefers-color-scheme) at MDN > References > CSS > @media.
+* [Responsive images](https://developer.mozilla.org/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images) at MDN > Guides > HTML > Multimedia and embedding.
+* [Service Worker API](https://developer.mozilla.org/docs/Web/API/Service_Worker_API) at MDN > References > Web APIs.
+* [Using Service Workers](https://developer.mozilla.org/docs/Web/API/Service_Worker_API/Using_Service_Workers) at MDN > References > Web APIs > Service Worker API > Guides.
+* [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN > References.
+* [Web Bluetooth API](https://developer.mozilla.org/docs/Web/API/Web_Bluetooth_API) at MDN > References > Web APIs.
+* [Web NFC API](https://developer.mozilla.org/docs/Web/API/Web_NFC_API) at MDN > References > Web APIs.
+* [USB](https://developer.mozilla.org/docs/Web/API/USB) at MDN > References > Web APIs > WebUSB API.
+* [WebAssembly](https://developer.mozilla.org/docs/WebAssembly) at MDN.
+* [Web Audio API](https://developer.mozilla.org/docs/Web/API/Web_Audio_API) at MDN > References > Web APIs.
+* [WebGL: 2D and 3D graphics for the web](https://developer.mozilla.org/docs/Web/API/WebGL_API) (WebGL API) at MDN > References > Web APIs.
+
+Wikipedia:
+* [Deep linking](https://wikipedia.org/wiki/Deep_linking)
+
+GitHub:
+* [PWAmp demo source code](https://github.com/MicrosoftEdge/Demos/blob/main/pwamp/app.js)
+* [PWAmp demo](https://microsoftedge.github.io/Demos/pwamp/)
+
+Other:
+* [PWA Builder](https://www.pwabuilder.com)
+* [Building Skeleton Screens with CSS Custom Properties](https://css-tricks.com/building-skeleton-screens-css-custom-properties/)
+* [virtual machines](https://developer.microsoft.com/microsoft-edge/tools/)<!-- todo: redirects to https://developer.microsoft.com/en-us/microsoft-edge/tools/?cs=2233647189&form=MA13LH - vm not listed -->
+* [WebAuthn API](https://webauthn.guide/)

microsoft-edge/progressive-web-apps-chromium/how-to/index.md

@@ -124,7 +124,11 @@ The app runs in the browser for now, and can't be installed. To make the app ins
 <!-- ====================================================================== -->
 ## Step 3 - Create a web app manifest
 
-A _web app manifest_ is a JSON file containing metadata about your app, such as its name, description, icons, and the various operating system features it uses.  For details, see [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN.
+A _web app manifest_ is a JSON file containing metadata about your app, such as its name, description, icons, and the various operating system features it uses.
+
+See:
+* [The web app manifest](https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest) in _Making PWAs installable_ at MDN > References > Progressive web apps > Guides.
+* [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN > References.
 
 To add an app manifest to your app:
 

microsoft-edge/progressive-web-apps-chromium/how-to/sidebar.md

@@ -26,7 +26,11 @@ By signaling intent to be pinned to the sidebar, your PWA gets the following ben
 
 To make your PWA ready for pinning to the sidebar in Microsoft Edge, use the `edge_side_panel` manifest member:
 
-1. Make sure your PWA has a web app manifest file that contains at least the `name`, `short_name`, `description`, and `icons` members.  For details, see [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN.
+1. Make sure your PWA has a web app manifest file that contains at least the `name`, `short_name`, `description`, and `icons` members.
+
+   For details, see:
+   * [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN.
+   * [The web app manifest](https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest) in _Making PWAs installable_ at MDN > References > Progressive web apps > Guides.
 
 1. Add the `edge_side_panel` member to your web app manifest. For example:
 

microsoft-edge/progressive-web-apps-chromium/how-to/window-controls-overlay.md

@@ -40,8 +40,9 @@ First, enable the Window Controls Overlay feature in your app's web app manifest
 ```
 
 See also:
-* [display_override](https://developer.mozilla.org/docs/Web/Manifest/display_override) at MDN.
-* [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN.
+* [display_override](https://developer.mozilla.org/docs/Web/Manifest/display_override) at MDN > References > Web app manifests.
+* [Web app manifests](https://developer.mozilla.org/docs/Web/Manifest) at MDN > References.
+* [The web app manifest](https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest) in _Making PWAs installable_ at MDN > References > Progressive web apps > Guides.
 
 
 <!-- ====================================================================== -->