Re: [screen-wake-lock] Add an Explainer document to the repository. (#286)

I've pushed a second commit incorporating some of Marcos' feedback. I've also reworded the kiosk item in "Why?", and added more context to what the System Wake Lock API did.

* Why
  - Stop mentioning "apps", reword the kiosk entry to make the use case more
    explicit.
* Non-goals
  - Briefly describe what the system wake lock API did.
* API
  - Do not say the API surface is not big.
  - Rework the example code.
  - Drop "Wake Lock" subsection, just mention how a lock is requested.
  - Stop referring to WakeLockSentinel.release() as if it were a static
    method.
* Security considerations
  - Also do not refer to WakeLockSentinel.release() as a static method.
  - Be more clear about how acquired locks are advisory-only.
  - Reword the item about battery consumption and battery depletion.


-- 
GitHub Notification of comment by rakuco
Please view or discuss this issue at https://github.com/w3c/screen-wake-lock/pull/286#issuecomment-695356216 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Saturday, 19 September 2020 21:08:35 UTC