Rename /pwa-getting-started/ dir to /temperature-converter/ (#104)

* rename dir

* clarify readme re old dir pwa-pwastore

* improve readmes PWA installer x2

* main readme pwastore row

* not favicon

* not simple

Author: mikehoffms

README.md

@@ -97,27 +97,28 @@ See also:
 <!-- ====================================================================== -->
 ## Progressive Web Apps (PWAs)
 <!-- sync:
-https://learn.microsoft.com/microsoft-edge/progressive-web-apps/demo-pwas
+https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/index
 https://github.com/MicrosoftEdge/Demos/blob/main/README.md#progressive-web-apps-pwas
-sync'd July 30, 2025
+sync'd Oct. 17, 2025
 -->
 
 | Demo name | Description and docs | Source code & Readme | Live demo page |
 |---|---|---|---|
-| 1DIV | A CSS sandbox app that demonstrates the Window Controls Overlay feature. | [/1DIV/](https://github.com/MicrosoftEdge/Demos/tree/main/1DIV) | [1DIV](https://microsoftedge.github.io/Demos/1DIV/dist/) demo |
-| Email client | A simulated email client PWA that demonstrates how to use PWA protocol handlers. | [/email-client/](https://github.com/MicrosoftEdge/Demos/tree/main/email-client) | [Email inbox](https://microsoftedge.github.io/Demos/email-client/) demo |
-| Application Title Meta Tag | Showcases the `application-title` meta tag. | [/pwa-application-title/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-application-title) | [application-title](https://microsoftedge.github.io/Demos/pwa-application-title/) demo |
-| Temperature converter | Converts temperatures.  Used for [Get started with PWAs](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/how-to/). | [/pwa-getting-started/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-getting-started) | [Temperature converter](https://microsoftedge.github.io/Demos/pwa-getting-started/) demo |
-| PWA installer | A PWA that uses the Web Install API to install other PWAs.  Also uses CSS Masonry. | [/pwa-installer/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-installer) | [pwa-installer](https://microsoftedge.github.io/Demos/pwa-installer/) demo |
-| Timer PWA | Has a **Set timer** button, and you can set the duration of the timer. | [/pwa-timer/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-timer) | [Timer PWA demo](https://microsoftedge.github.io/Demos/pwa-timer/) |
-| PWA To Do | Create lists of tasks locally in your browser, or by installing the app.  Click **About** link in rendered demo. | [/pwa-to-do/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-to-do) | [PWA To Do](https://microsoftedge.github.io/Demos/pwa-to-do/) demo |
-| PWAmp | A music player that plays local audio files. | [/pwamp/](https://github.com/MicrosoftEdge/Demos/tree/main/pwamp) | [pwamp](https://microsoftedge.github.io/Demos/pwamp/) demo |
-| wami | An image manipulation app to crop, resize, or add effects to images. | [/wami/](https://github.com/MicrosoftEdge/Demos/tree/main/wami) | [wami](https://microsoftedge.github.io/Demos/wami/) demo |
-
-<!-- todo: change from [Get started with PWAs] to [Temperature convertor sample] after merge https://github.com/MicrosoftDocs/edge-developer/pull/3476 -->
+| 1DIV | A CSS sandbox app that demonstrates the Window Controls Overlay feature. | [/1DIV/](https://github.com/MicrosoftEdge/Demos/tree/main/1DIV/) | [1DIV](https://microsoftedge.github.io/Demos/1DIV/dist/) demo |
+| Email client | A simulated email client PWA that demonstrates how to use PWA protocol handlers. | [/email-client/](https://github.com/MicrosoftEdge/Demos/tree/main/email-client/) | [Email inbox](https://microsoftedge.github.io/Demos/email-client/) demo |
+| Application Title Meta Tag | Showcases the `application-title` meta tag. | [/pwa-application-title/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-application-title/) | [application-title](https://microsoftedge.github.io/Demos/pwa-application-title/) demo |
+| PWA installer | A PWA that uses the Web Install API to install other PWAs.  Also uses CSS Masonry. | [/pwa-installer/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-installer/) | [pwa-installer](https://microsoftedge.github.io/Demos/pwa-installer/) demo |
+| Edge demos (pwastore) | A PWA that uses the Web Install API to install other PWAs.  Also uses CSS Masonry.  An earlier copy of `/pwa-installer/` directory, pointed to by Dev Trial docs. | [/pwa-pwastore/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-pwastore/) | [Edge demos](https://microsoftedge.github.io/Demos/pwa-pwastore/) |
+| Timer PWA | Has a **Set timer** button, and you can set the duration of the timer. | [/pwa-timer/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-timer/) | [Timer PWA demo](https://microsoftedge.github.io/Demos/pwa-timer/) |
+| PWA To Do | Create lists of tasks locally in your browser, or by installing the app.  Click **About** link in rendered demo. | [/pwa-to-do/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-to-do/) | [PWA To Do](https://microsoftedge.github.io/Demos/pwa-to-do/) demo |
+| PWAmp | A music player that plays local audio files. | [/pwamp/](https://github.com/MicrosoftEdge/Demos/tree/main/pwamp/) | [pwamp](https://microsoftedge.github.io/Demos/pwamp/) demo |
+| Temperature converter | Converts temperatures.  Used for [Temperature convertor sample](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/temperature-converter). | [/temperature-converter/](https://github.com/MicrosoftEdge/Demos/tree/main/temperature-converter/) | [Temperature converter](https://microsoftedge.github.io/Demos/pwa-getting-started/) demo |
+| wami | An image manipulation app to crop, resize, or add effects to images. | [/wami/](https://github.com/MicrosoftEdge/Demos/tree/main/wami/) | [wami](https://microsoftedge.github.io/Demos/wami/) demo |
+
+To learn how to use and develop PWAs, start with the Temperature convertor sample.
 
 See also:
-* [Progressive Web App demos](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/demo-pwas) - also lists the demos:
+* [Progressive Web App samples](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/index) - also lists the demos:
    * My Movie List
    * My Tracks
    * BPM Techno

email-client/README.md

@@ -40,4 +40,4 @@ The two interesting pieces of code here are:
 
 * [Test Progressive Web App (PWA) protocol handling](https://learn.microsoft.com/microsoft-edge/devtools/progressive-web-apps/protocol-handlers)
 * [Handle protocols in a PWA](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/how-to/handle-protocols)
-* [Email client](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/demo-pwas#email-client) in _Progressive Web App demos_.
+* [Email client](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/index#email-client) in _Progressive Web App samples_.

pwa-getting-started/README.md

@@ -2,15 +2,23 @@
 
 ➡️ **[Open the demo](https://microsoftedge.github.io/Demos/pwa-installer/)** ⬅️
 
-**PWA installer** is a demo app for a landing page that lets you install PWAs from a collection of applications.  This demo app showcases the Web Install API.
+**PWA installer** is a demo app for a landing page (titled **Edge demos** ) that lets you install PWAs from a collection of applications.
+
+This demo app showcases the Web Install API.  This demo app also demonstrates CSS Masonry layout.
 
 
 <!-- ====================================================================== -->
 ## Requirements
 
-For the demo to work correctly, you must enable a flag, which is available in browsers based on Chromium, such as Microsoft Edge, starting with version 139.
+* For the demo to work correctly, you must enable a flag for the Web Install API.  That flag is available in browsers based on Chromium, such as Microsoft Edge, starting with version 139.
+
+* As a progressive enhancement, you can also enable the CSS Masonry flag.
+
+
+<!-- ------------------------------ -->
+### Enable the Web Install API
 
-To enable the flag:
+To enable the Web Install API (required):
 
 1. In the browser, open a new tab and go to `about:flags`.
 
@@ -22,9 +30,11 @@ To enable the flag:
 
 1. Click the **Restart** button in the lower right.  The browser restarts.
 
-1. In the same browser, go to [https://microsoftedge.github.io/Demos/pwa-installer/](https://microsoftedge.github.io/Demos/pwa-installer/) or your localhost equivalent.
 
-This demo also makes use of CSS masonry layout, as a progressive enhancement.  You can optionally enable the CSS masonry flag:
+<!-- ------------------------------ -->
+### Enable CSS Masonry layout
+
+To enable the CSS Masonry layout flag (a progressive enhancement):
 
 1. In the browser, open a new tab and go to `about:flags`.
 
@@ -40,6 +50,14 @@ This demo also makes use of CSS masonry layout, as a progressive enhancement.  Y
 <!-- ====================================================================== -->
 ## See also
 
+Sample description:
+* [PWA installer](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/index#pwa-installer) in _Progressive Web App samples_.
+
+Blog post:
+* [Microsoft Edge: Web Install API Dev Trial Live](https://www.linkedin.com/feed/update/urn:li:activity:7348768177993998337/)
+
+Explainer:
 * [Web Install API](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/WebInstall/explainer.md)
-* [PWA installer](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/demo-pwas#pwa-installer) in _Progressive Web App demos_.
+
+Other live samples:
 * [Web Install Sample](https://kbhlee2121.github.io/pwa/web-install/index.html) - requires the **web-app-installation-api** flag.

pwa-installer/README.md

@@ -1,9 +1,67 @@
-# Edge demos 
+# Edge demos
 
 ➡️ **[Open the demo](https://microsoftedge.github.io/Demos/pwa-pwastore/)** ⬅️
 
-**Edge demos** is a demo app for a landing page of a collection of applications.
+This is a demo app for a landing page (titled **Edge demos** ) that lets you install PWAs from a collection of applications.
 
-## Requirements 
+This demo app showcases the Web Install API.  This demo app also demonstrates CSS Masonry layout.
 
-This demo application showcases the Web Install API and the "Masonry" layout. You need to enable 2 separate flags in `about://flags` for the demo to work correctly (`#css-masonry-layout`/`#web-app-installation-api`) available in Chromium browsers versions M139+.
+The `/pwa-pwastore/` directory is an earlier copy of [/pwa-installer/](https://github.com/MicrosoftEdge/Demos/tree/main/pwa-installer/).  The Web Install API Dev Trial docs point to this earlier, `/pwa-pwastore/` directory, not to the later, `/pwa-installer/` directory.
+
+
+<!-- ====================================================================== -->
+## Requirements
+
+This demo application showcases the Web Install API, and also CSS Masonry layout.
+
+* For the demo to work correctly, you must enable a flag for the Web Install API.  That flag is available in browsers based on Chromium, such as Microsoft Edge, starting with version 139.
+
+* As a progressive enhancement, you can also enable the CSS Masonry flag.
+
+
+<!-- ------------------------------ -->
+### Enable the Web Install API
+
+To enable the Web Install API (required):
+
+1. In the browser, open a new tab and go to `about:flags`.
+
+   In Microsoft Edge, you end up at `edge://flags`.
+
+1. In the **Search** box, enter **web-app-installation-api**.
+
+1. Set the **Web App Installation API** flag to **Enabled**.
+
+1. Click the **Restart** button in the lower right.  The browser restarts.
+
+
+<!-- ------------------------------ -->
+### Enable CSS Masonry layout
+
+To enable the CSS Masonry layout flag (a progressive enhancement):
+
+1. In the browser, open a new tab and go to `about:flags`.
+
+   In Microsoft Edge, you end up at `edge://flags`.
+
+1. In the **Search** box, enter **css-masonry-layout**.
+
+1. Set the **CSS Masonry Layout** flag to **Enabled**.
+
+1. Click the **Restart** button in the lower right.  The browser restarts.
+
+
+<!-- ====================================================================== -->
+## See also
+
+Sample description:
+* [PWA installer](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/index#pwa-installer) in _Progressive Web App samples_.
+
+Blog post:
+* [Microsoft Edge: Web Install API Dev Trial Live](https://www.linkedin.com/feed/update/urn:li:activity:7348768177993998337/)
+
+Explainer:
+* [Web Install API](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/WebInstall/explainer.md)
+
+Other live samples:
+* [Web Install Sample](https://kbhlee2121.github.io/pwa/web-install/index.html) - requires the **web-app-installation-api** flag.

pwa-pwastore/README.md

@@ -92,7 +92,7 @@ Possible enhancements for this demo:
 
 Find "PWAmp" in the following articles.
 
-* [PWAmp](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/demo-pwas#pwamp) in _Progressive Web App demos_.
+* [PWAmp](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/index#pwamp) in _Progressive Web App samples_.
 * [Console features reference](https://learn.microsoft.com/microsoft-edge/devtools/console/reference)
 * [Test Progressive Web App (PWA) protocol handling](https://learn.microsoft.com/microsoft-edge/devtools/progressive-web-apps/protocol-handlers)
 * [View and change IndexedDB data](https://learn.microsoft.com/microsoft-edge/devtools/storage/indexeddb)

pwamp/README.md

@@ -0,0 +1,7 @@
+# Temperature converter
+
+➡️ **[Open the demo](https://microsoftedge.github.io/Demos/pwa-getting-started/)** ⬅️
+
+A demo Progressive Web App (PWA) that converts temperatures.  To start learning to use and develop PWAs, start with this sample.
+
+For instructions, see [Temperature convertor sample](https://learn.microsoft.com/microsoft-edge/progressive-web-apps/samples/temperature-converter).