Re: [permissions] Version of the API that should be simple, extensible and ready for MVP. (#20)

> @@ -185,6 +185,23 @@
>      </section>
>      <section>
>        <h2>
> +        Permission description
> +      </h2>
> +      <dl class='idl' title='dictionary PermissionDescriptor'>
> +        <dt>
> +          required PermissionName <a>name</a>
> +        </dt>
> +      </dl>
> +      <p>
> +        A permission is defined by a name and other properties that depends on
> +        the name. The simplest permissions require only a name but some others
> +        will require more information. In which case, they should have an
> +        <dfn>associated PermissionDescriptor</dfn> dictionary that inherits

Don't say what it inherits from. It's redundant. Maybe say:

```HTML
In which case, they will have an <dfn>associated permission descriptor</dfn>, which is represented by the <code>PermissionDescriptor</code> dictionary. 
```

---
Reply to this email directly or view it on GitHub:
https://github.com/w3c/permissions/pull/20/files#r27515461