From d618f0933fac048f02a5d18fe84909465092db8c Mon Sep 17 00:00:00 2001
From: Alan Cutter <alancutter@chromium.org>
Date: Fri, 28 Oct 2022 16:04:36 +1100
Subject: [PATCH] git squash commit for launch-web-app.

6df8c285124ada2d39bd853e1c34fda409e954a4
git squash commit for launch-web-app.

bec2daf40e63e33cb79347c7f65000f4cf746c19
Branch: launch-web-app

3cf3b6c89704ab27ac3d1b88b23588d7f79726c2
Fix refs

7e4f5d73e6fec087439efee7cc593905919e6cbd
line wrap
---
 index.html | 50 ++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 38 insertions(+), 12 deletions(-)

diff --git a/index.html b/index.html
index 592c573da..b1f2b27ce 100644
--- a/index.html
+++ b/index.html
@@ -78,7 +78,13 @@
           "ios_saf",
         ],
       },
-      xref: "web-platform",
+      xref: {
+        profile: "web-platform",
+        specs: [
+          "service-workers",
+          "html",
+        ],
+      },
     };
     </script>
     <style>
@@ -1986,18 +1992,10 @@ <h3>
         </h3>
         <p>
           When <a>shortcut item</a> <var>shortcut</var> having
-          <var>manifest</var> is invoked, run the following steps:
+          <var>manifest</var> is invoked, run the steps to
+          [=launch a web application=] given <var>mainfest</var> and
+          <var>shortcut.url</var>.
         </p>
-        <ol class="algorithm">
-          <li>Let <var>url</var> be <var>shortcut.url</var>.
-          </li>
-          <li>Let <var>browsing context</var> be the result of creating a new
-          <a>top-level browsing context</a>.
-          </li>
-          <li>
-            <a>Navigate</a> <var>browsing context</var> to <var>url</var>.
-          </li>
-        </ol>
       </section>
       <section>
         <h2>
@@ -2249,6 +2247,34 @@ <h3>
           available underneath an icon).
         </p>
       </section>
+      <section>
+        <h3 id="installation-sec">
+          Launching a web application
+        </h3>
+        <p>
+          The steps to <dfn>launch a web application</dfn> is given by the
+          following algorithm. The algorithm takes a
+          [=Document/processed manifest=] |manifest:processed manifest|,
+          an optional |target URL:URL| and returns a
+          [=service worker client/window client=].
+        </p>
+        <ol class="algorithm">
+          <li>If <var>url</var> is unset, set <var>url</var> to
+              |manifest|.[=manifest/start_url=].
+          </li>
+          <li>Let |client| be the result of
+              <a href="https://html.spec.whatwg.org/multipage/browsers.html#creating-a-new-top-level-browsing-context">
+              creating a new top-level browsing context</a>.
+          </li>
+          <li><a data-cite="appmanifest#dfn-applied">Apply</a> |manifest| to
+              |client|.
+          </li>
+          <li>Run the steps to [=navigate=] |client| passing |url|.
+          </li>
+          <li>Return |client|.
+          </li>
+        </ol>
+      </section>
       <section>
         <h3 id="installation-sec">
           Privacy and security considerations