[wake-lock] User real instances of things (#185)

marcoscaceres has just created a new issue for https://github.com/w3c/wake-lock:

== User real instances of things ==
The spec says things like: 

> Within this section, |descriptor| is an instance of the <a>permission descriptor type</a>

Please avoid citing concepts as instances of IDL interfaces. You probably want:

> Within this section, |descriptor:WakeLockPermissionDescriptor| is an instance of the {{WakeLockPermissionDescriptor}}.

Same applies globally... use real types. 

Note: the above original sentence also weird... you should "Let |descriptor| be ..." in  an algorithm.  


Please view or discuss this issue at https://github.com/w3c/wake-lock/issues/185 using your GitHub account

Received on Saturday, 20 April 2019 14:29:19 UTC