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

• From: Marcos Cáceres via GitHub <sysbot+gh@w3.org>
• Date: Sat, 20 Apr 2019 14:29:17 +0000
• To: public-device-apis-log@w3.org
• Message-ID: <issues.opened-435405360-1555770556-sysbot+gh@w3.org>

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