From a38a519f97102d8a4e0ce2321ff34dc1e9b0ea93 Mon Sep 17 00:00:00 2001
From: Daniel Murphy <dmurph@chromium.org>
Date: Wed, 1 Mar 2023 16:08:10 -0800
Subject: [PATCH] Revert "addressing comments, adding dfn"

This reverts commit edc398d94aef301a407936fcda8ef1745f0ce7cd.
---
 index.html | 63 ++++++++++++++++++++++--------------------------------
 1 file changed, 26 insertions(+), 37 deletions(-)

diff --git a/index.html b/index.html
index b9248d47..fc518671 100644
--- a/index.html
+++ b/index.html
@@ -2553,11 +2553,21 @@ <h3>
           Web Apps with scope conflicts
         </h3>
         <p>
-          Because scopes are based on URL matching, it is possible for a
-          developer to create multiple web applications with the same,
-          overlapping, or nested scopes. Doing so creates several issues
-          (detailed below) and is thus considered bad practice.
+          Because scopes are based on URL matching, it is possible for a developer to create
+          multiple web applications with the same, overlapping, or nested scopes. Doing so creates
+          several issues (detailed below) and is thus considered bad practice.
         </p>
+        <ul>
+          <li>The scopes of the two web apps can be on the same origin. Not
+          recommended.
+          </li>
+          <li>The scope of one web app can be nested inside the scope of the
+          other. Strongly not recommended.
+          </li>
+          <li>The scopes of the two web apps can be the same. Strongly not
+          recommended.
+          </li>
+        </ul>
         <p>
           Same-origin scopes are not recommended due to origin-based settings
           that will affect all apps installed under that origin. Settings like:
@@ -2567,49 +2577,28 @@ <h3>
           </li>
           <li>Storage and storage quota
           </li>
-          <li>User settings (e.g. font size, zoom level)
+          <li>User settings (e.g. font size)
           </li>
         </ul>
         <p>
-          To aide with disambiguation apps with scope conflicts, user agents
-          can determine the <dfn>controlling app</dfn> for a given document
-          URL, which is an [=installed web application=] with the longest
-          [=manifest/scope=] where the document url is [=manifest/within
-          scope=] of that application. If multiple apps fit this description
-          (in the case of matching scopes), then the user agent may choose
-          none, one, or all, depending on the scenario.
-        </p>
-        <p>
-          The following scenarios may require the user agent choosing a
-          [=controlling app=], not work, or be unpredictable with nested or
-          matching scopes:
+          Further, overlapping, nested, or duplicate scopes can have the following UX and
+          API problems or inconsistencies among other possible consistencies:
         </p>
         <ul>
-          <li>Installation prompting.
+          <li>Installation prompting may not work for the nested app if the
+          outer app is installed.
           </li>
-          <li>User-agent UX around launching an app for a browsing context.
+          <li>User-agent UX around launching an app for a browsing context may
+          be inconsistent or not appear.
           </li>
-          <li>Notifications and notification attribution.
+          <li>Badging API calls will not be able to consistently update the
+          correct web app badge.
           </li>
-          <li>And current or future APIs that somehow correspond to a single web app identity
-          (e.g. badging).
+          <li>Notifications may have incorrect attribution or not appear.
+          </li>
+          <li>Future APIs may not work at all in this configuration.
           </li>
         </ul>
-        <aside class="example">
-          <p>
-            If a user agent supports the notifications API and there are two
-            apps installed with matching scopes, which app should be seen as
-            the author of that notification if it comes from within the scope
-            of both?
-          </p>
-          <p>
-            If two apps are nested and a notification is triggered within scope
-            of both, the notification will likely be attributed to the
-            [=controlling app=]. But what if the nested app is not installed,
-            and the outer app is? Is the developer expecting the notification
-            to be attributed to the outer app?
-          </p>
-        </aside>
       </section>
     </section>
     <section>