Re: [w3c/permissions] Editorial: cleanup Permissions model (PR #355)

@miketaylr approved this pull request.

lgtm % suggestions

> @@ -148,15 +148,21 @@ <h3>
           Permissions
         </h3>
         <p>
-          A <dfn class="export">permission</dfn> represents a user's decision to allow a web
-          application to access a [=powerful feature=].
+          A <dfn class="export">permission</dfn> represents a user's decision as to whether a web
+          application can use a [=powerful feature=]. The decision is represented as a permission
+          [=permission/state=].
+        </p>
+        <p>
+          <dfn class="export">Express permission</dfn> refers to an act by the user, e.g. via user
+          interface or host device platform features, through which the user [=permission/grants=]
+          [=permission=] the use of the feature by the web application.

```suggestion
          [=permission=] for use of a feature by a web application.
```

>          </p>
-        <dl>
+        <dl data-sort="">

(neat, TIL https://respec.org/docs/#data-sort)

> @@ -212,6 +218,15 @@ <h3>
             implicit signals.
           </p>
         </aside>
+        <p>
+          Every [=permission=] has a <dfn class="export" data-dfn-for="permission">lifetime</dfn>,
+          which is the duration for which a particular permission remains [=permission/granted=]
+          before it reverts back to its [=permission/default state=]. A [=permission/lifetime=]
+          could be until a particular Realm is destroyed, until a particular [=top-level browsing
+          context=] is destroyed, an amount of time, or infinite. The lifetime is negotiated
+          between the end-user and the [=user agent=] when the user gives [=express permission=] to
+          use a [=feature=] - usually via some permission UI or policy.

```suggestion
          use a [=feature=]—usually via some permission UI or user-agent defined policy.
```

-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3c/permissions/pull/355#pullrequestreview-873363671

You are receiving this because you are subscribed to this thread.

Message ID: <w3c/permissions/pull/355/review/873363671@github.com>