From 7d225cb118bb7221603dfb8766e6559ae45e9879 Mon Sep 17 00:00:00 2001
From: Marcos Caceres <marcos@marcosc.com>
Date: Fri, 25 Nov 2022 15:26:00 +1300
Subject: [PATCH 1/2] Define and improve use of permissions task source

---
 index.html | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/index.html b/index.html
index 79a7308..dcc9157 100644
--- a/index.html
+++ b/index.html
@@ -362,6 +362,15 @@ <h3>
           </aside>
         </section>
       </section>
+      <section>
+        <h3>
+          Permissions task source
+        </h3>
+        <p>
+          The <dfn class="export">permissions task source</dfn> is a [=task source=] used to
+          perform permissions-related [=tasks=] in this specification.
+        </p>
+      </section>
     </section>
     <section>
       <h2>
@@ -827,9 +836,9 @@ <h4 id="query-method">
             <li>If the conversion [=exception/throws=] an [=exception=], return <a>a promise
             rejected with</a> that exception.
             </li>
-            <li>Let <var>promise</var> be [=a new promise=].
+            <li>Let |promise:Promise| be [=a new promise=].
             </li>
-            <li>Return <var>promise</var> and continue [=in parallel=]:
+            <li>Return |promise| and continue [=in parallel=]:
               <ol>
                 <li>Let |status| be <a>create a `PermissionStatus`</a> with |typedDescriptor|.
                 </li>
@@ -838,7 +847,8 @@ <h4 id="query-method">
                 <li>Run |query|'s {{PermissionDescriptor/name}}'s [=powerful feature/permission
                 query algorithm=], passing |query| and |status|.
                 </li>
-                <li>[=Resolve=] <var>promise</var> with |status|.
+                <li>[=Queue a global task=] on the [=permissions task source=] with [=this=]'s
+                [=relevant global object=] to [=resolve=] |promise| with |status|.
                 </li>
               </ol>
             </li>
@@ -946,8 +956,8 @@ <h4>
             algorithm=], passing |query| and |status|.
             </li>
             <li>
-              <a>Queue a task</a> on the <dfn class="export">permissions task source</dfn> to
-              <a>fire an event</a> named <code>change</code> at |status|.
+              <a>Queue a task</a> on the [=permissions task source=] to <a>fire an event</a> named
+              <code>change</code> at |status|.
             </li>
           </ol>
         </section>
@@ -1092,7 +1102,7 @@ <h3 id="set-permission-command">
           <li>For each <a>environment settings object</a> |target| in |targets|:
             <ol>
               <li>
-                <a>Queue a task</a> |task| on the <a>permissions task source</a> of |target|'s
+                <a>Queue a task</a> |task| on the [=permissions task source=] of |target|'s
                 [=relevant settings object=]'s [=environment settings object/global object=]'s
                 [=Window/browsing context=] to perform the following step:
                 <ol>

From 50f1d855b08bf34aed143027397733a25061c442 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= <marcos@marcosc.com>
Date: Thu, 8 Dec 2022 12:03:26 +1100
Subject: [PATCH 2/2] Update index.html

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index dcc9157..acd0919 100644
--- a/index.html
+++ b/index.html
@@ -367,7 +367,7 @@ <h3>
           Permissions task source
         </h3>
         <p>
-          The <dfn class="export">permissions task source</dfn> is a [=task source=] used to
+          The <dfn>permissions task source</dfn> is a [=task source=] used to
           perform permissions-related [=tasks=] in this specification.
         </p>
       </section>