Skip to content

Commit

Permalink
Fix #23: Move content from Use Cases to Scope
Browse files Browse the repository at this point in the history
- Update [MEDIAQUERIES-4] -> [MEDIAQUERIES-5]
  (note: not published on TR, thus no specref entry)
  • Loading branch information
anssiko committed Aug 21, 2017
1 parent f03e2b3 commit 8f9b5fc
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 12 deletions.
13 changes: 8 additions & 5 deletions index.bs
Expand Up @@ -46,6 +46,14 @@ The Ambient Light Sensor extends the Generic Sensor API [[GENERIC-SENSOR]]
to provide information about ambient light levels,
as detected by the device's main light detector, in terms of lux units.

Scope {#scope}
-----

For document styling use cases that do not require accuracy, low latency, and high frequency,
the `light-level` CSS media feature [[MEDIAQUERIES-5]] can be more appropriate. The `light-level`
media feature has a set of pre-defined values that represents a composite of screen brightness,
screen technology, ambient light level, and possibly other factors depending on implementation.

Note: it might be worthwhile to provide a <a>high-level</a> Light Level Sensor
which would mirror the `light-level` media feature, but in JavaScript.
This sensor would *not require additional user permission to be activated*
Expand Down Expand Up @@ -149,11 +157,6 @@ While some of the use cases may benefit from obtaining precise ambient light mea
cases that convert ambient light level fluctuations to user input events, would benefit from
higher [=sampling frequency|sampling frequencies=].

Note: For document styling use cases that do not require accuracy, low latency, and high frequency,
the `light-level` CSS media feature [[MEDIAQUERIES-4]] can be more appropriate. The `light-level`
media feature has a set of pre-defined values that represents a composite of screen brightness,
screen technology, ambient light level, and possibly other factors depending on implementation.

Acknowledgements {#acknowledgements}
================

Expand Down
17 changes: 10 additions & 7 deletions index.html
Expand Up @@ -1431,7 +1431,7 @@
<div class="head">
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2016/logos/W3C" width="72"> </a> </p>
<h1 class="p-name no-ref" id="title">Ambient Light Sensor</h1>
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2017-08-18">18 August 2017</time></span></h2>
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2017-08-21">21 August 2017</time></span></h2>
<div data-fill-with="spec-metadata">
<dl>
<dt>This version:
Expand Down Expand Up @@ -1493,7 +1493,11 @@ <h2 class="no-num no-toc no-ref heading settled" id="sotd"><span class="content"
<nav data-fill-with="table-of-contents" id="toc">
<h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<ol class="toc" role="directory">
<li><a href="#intro"><span class="secno">1</span> <span class="content">Introduction</span></a>
<li>
<a href="#intro"><span class="secno">1</span> <span class="content">Introduction</span></a>
<ol class="toc">
<li><a href="#scope"><span class="secno">1.1</span> <span class="content">Scope</span></a>
</ol>
<li><a href="#examples"><span class="secno">2</span> <span class="content">Examples</span></a>
<li><a href="#security-and-privacy"><span class="secno">3</span> <span class="content">Security and Privacy Considerations</span></a>
<li><a href="#model"><span class="secno">4</span> <span class="content">Model</span></a>
Expand Down Expand Up @@ -1528,6 +1532,10 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<h2 class="heading settled" data-level="1" id="intro"><span class="secno">1. </span><span class="content">Introduction</span><a class="self-link" href="#intro"></a></h2>
<p>The Ambient Light Sensor extends the Generic Sensor API <a data-link-type="biblio" href="#biblio-generic-sensor">[GENERIC-SENSOR]</a> to provide information about ambient light levels,
as detected by the device’s main light detector, in terms of lux units.</p>
<h3 class="heading settled" data-level="1.1" id="scope"><span class="secno">1.1. </span><span class="content">Scope</span><a class="self-link" href="#scope"></a></h3>
<p>For document styling use cases that do not require accuracy, low latency, and high frequency,
the <code>light-level</code> CSS media feature <span>[MEDIAQUERIES-5]</span> can be more appropriate. The <code>light-level</code> media feature has a set of pre-defined values that represents a composite of screen brightness,
screen technology, ambient light level, and possibly other factors depending on implementation.</p>
<p class="note" role="note"><span>Note:</span> it might be worthwhile to provide a <a data-link-type="dfn" href="https://w3c.github.io/sensors#high-level" id="ref-for-high-level">high-level</a> Light Level Sensor
which would mirror the <code>light-level</code> media feature, but in JavaScript.
This sensor would <em>not require additional user permission to be activated</em> in user agents that exposed the <code>light-level</code> media feature.</p>
Expand Down Expand Up @@ -1610,9 +1618,6 @@ <h2 class="heading settled" data-level="6" id="usecases-requirements"><span clas
<p>While some of the use cases may benefit from obtaining precise ambient light measurements, the use
cases that convert ambient light level fluctuations to user input events, would benefit from
higher <a data-link-type="dfn" href="https://w3c.github.io/sensors#sampling-frequency" id="ref-for-sampling-frequency">sampling frequencies</a>.</p>
<p class="note" role="note"><span>Note:</span> For document styling use cases that do not require accuracy, low latency, and high frequency,
the <code>light-level</code> CSS media feature <a data-link-type="biblio" href="#biblio-mediaqueries-4">[MEDIAQUERIES-4]</a> can be more appropriate. The <code>light-level</code> media feature has a set of pre-defined values that represents a composite of screen brightness,
screen technology, ambient light level, and possibly other factors depending on implementation.</p>
<h2 class="heading settled" data-level="7" id="acknowledgements"><span class="secno">7. </span><span class="content">Acknowledgements</span><a class="self-link" href="#acknowledgements"></a></h2>
<p>Doug Turner for the initial prototype and
Marcos Caceres for the test suite.</p>
Expand Down Expand Up @@ -1694,8 +1699,6 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-mediaqueries-4">[MEDIAQUERIES-4]
<dd>Florian Rivoal; Tab Atkins Jr.. <a href="https://drafts.csswg.org/mediaqueries-4/">Media Queries Level 4</a>. URL: <a href="https://drafts.csswg.org/mediaqueries-4/">https://drafts.csswg.org/mediaqueries-4/</a>
<dt id="biblio-si">[SI]
<dd><a href="http://www.bipm.org/en/publications/si-brochure/">SI Brochure: The International System of Units (SI), 8th edition</a>. 2014. URL: <a href="http://www.bipm.org/en/publications/si-brochure/">http://www.bipm.org/en/publications/si-brochure/</a>
</dl>
Expand Down

0 comments on commit 8f9b5fc

Please sign in to comment.