From 70dce99e160f2e4cfd145c52869e14bc3073411c Mon Sep 17 00:00:00 2001
From: Rik Cabanier <rcabanier@mlla2374.magicleap.ds>
Date: Tue, 29 May 2018 21:46:46 -0700
Subject: [PATCH 1/4] Added the first proposal for a 'reality' keyword.

---
 mediaqueries-5/Overview.bs | 46 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/mediaqueries-5/Overview.bs b/mediaqueries-5/Overview.bs
index e24f673f2c4..c3430da0080 100644
--- a/mediaqueries-5/Overview.bs
+++ b/mediaqueries-5/Overview.bs
@@ -148,6 +148,52 @@ Detecting the ambient light level: the 'light-level' feature</h3>
 		</pre>
 	</div>
 
+<h3 id="reality">
+Detecting the display technology: the 'reality' feature</h3>
+
+<pre class='descdef mq'>
+Name: reality
+Value: 2D | mixed | virtual
+For: @media
+Type: discrete
+</pre>
+
+The 'reality' media feature is used to query the environment of the user's display
+so the author can adjust the style of the document.
+An author might choose to adjust the visuals and/or layout of the page depending on the display technology to increase the appeal or improve legibility.
+
+The following values are valid:
+
+<dl dfn-type=value dfn-for="@media/reality">
+<dt><dfn>2D</dfn>
+<dd>
+The device is a traditional screen or monitor. The web page typically doesn't interact with other pages or applications.
+
+<dt><dfn>mixed</dfn>
+<dd>
+The device is a mixed reality device. The web page is part of the real world which potentially contains other web pages or applications.
+
+<dt><dfn>virtual</dfn>
+<dd>
+The device is a virtual reality device.
+
+</dl>
+
+Issue: Is there a need for the 'virtual' value?
+
+<div class="example">
+<pre>
+body { background-color: white; }
+p { color: black; }
+
+@media(reality: mixed) {
+  body { background-color: black; }
+  p { color: white; font-size: 16px; font-weight: 1100; }
+}
+</pre>
+</div>
+
+
 
 <!--
  ██████   ██████  ████████  ████ ████████  ████████ ████ ██    ██  ██████

From 1a3432028cfa3ea7f4fc1555c2e25995e8733561 Mon Sep 17 00:00:00 2001
From: Rik Cabanier <rcabanier@mlla2374.magicleap.ds>
Date: Wed, 6 Jun 2018 21:03:20 -0700
Subject: [PATCH 2/4] Renamed from reality to environment-blending

---
 mediaqueries-5/Overview.bs | 32 ++++++++++++++++++--------------
 1 file changed, 18 insertions(+), 14 deletions(-)

diff --git a/mediaqueries-5/Overview.bs b/mediaqueries-5/Overview.bs
index c3430da0080..acd82012645 100644
--- a/mediaqueries-5/Overview.bs
+++ b/mediaqueries-5/Overview.bs
@@ -148,47 +148,51 @@ Detecting the ambient light level: the 'light-level' feature</h3>
 		</pre>
 	</div>
 
-<h3 id="reality">
-Detecting the display technology: the 'reality' feature</h3>
+<h3 id="environment-blending">
+Detecting the display technology: the 'environment-blending' feature</h3>
 
 <pre class='descdef mq'>
-Name: reality
-Value: 2D | mixed | virtual
+Name: environment-blending
+Value: opaque | additive | subtractive
 For: @media
 Type: discrete
 </pre>
 
-The 'reality' media feature is used to query the environment of the user's display
+The 'environment-blending' media feature is used to query the environment of the user's display
 so the author can adjust the style of the document.
 An author might choose to adjust the visuals and/or layout of the page depending on the display technology to increase the appeal or improve legibility.
 
 The following values are valid:
 
 <dl dfn-type=value dfn-for="@media/reality">
-<dt><dfn>2D</dfn>
+<dt><dfn>opaque</dfn>
 <dd>
-The device is a traditional screen or monitor. The web page typically doesn't interact with other pages or applications.
+The display is a traditional screen or monitor. The web page doesn't interact with other display or the environment. Black is dark and white is 100% light.
 
-<dt><dfn>mixed</dfn>
+<dt><dfn>additive</dfn>
 <dd>
-The device is a mixed reality device. The web page is part of the real world which potentially contains other web pages or applications.
+The web content is blended with the real world with additive mixing. Black is fully transparent and white is 100% light. Colors typically add their values to the observed world.
 
-<dt><dfn>virtual</dfn>
+For example: a head-up display in a car.
+
+<dt><dfn>subtractive</dfn>
 <dd>
-The device is a virtual reality device.
+The web content is blended with the real world using subtractive mixing. White is fully transparent and dark colors have the most contrast.
+
+For example: an LCD display embedded in a bathroom mirror.
 
 </dl>
 
-Issue: Is there a need for the 'virtual' value?
+Issue: Is there a need for the 'subtractive' value?
 
 <div class="example">
 <pre>
 body { background-color: white; }
 p { color: black; }
 
-@media(reality: mixed) {
+@media(environment-blending: additive) {
   body { background-color: black; }
-  p { color: white; font-size: 16px; font-weight: 1100; }
+  p { color: white; font-size: 16px; font-weight: 1000; }
 }
 </pre>
 </div>

From 370af9a5e4a614ba2bcd2fcbbe2e09013629236c Mon Sep 17 00:00:00 2001
From: Rik Cabanier <rcabanier@mlla2374.magicleap.ds>
Date: Sat, 9 Jun 2018 20:15:29 -0700
Subject: [PATCH 3/4] Incorporated fantasai's comments

---
 mediaqueries-5/Overview.bs | 93 ++++++++++++++++++++------------------
 1 file changed, 48 insertions(+), 45 deletions(-)

diff --git a/mediaqueries-5/Overview.bs b/mediaqueries-5/Overview.bs
index acd82012645..fd1b6602a71 100644
--- a/mediaqueries-5/Overview.bs
+++ b/mediaqueries-5/Overview.bs
@@ -151,51 +151,54 @@ Detecting the ambient light level: the 'light-level' feature</h3>
 <h3 id="environment-blending">
 Detecting the display technology: the 'environment-blending' feature</h3>
 
-<pre class='descdef mq'>
-Name: environment-blending
-Value: opaque | additive | subtractive
-For: @media
-Type: discrete
-</pre>
-
-The 'environment-blending' media feature is used to query the environment of the user's display
-so the author can adjust the style of the document.
-An author might choose to adjust the visuals and/or layout of the page depending on the display technology to increase the appeal or improve legibility.
-
-The following values are valid:
-
-<dl dfn-type=value dfn-for="@media/reality">
-<dt><dfn>opaque</dfn>
-<dd>
-The display is a traditional screen or monitor. The web page doesn't interact with other display or the environment. Black is dark and white is 100% light.
-
-<dt><dfn>additive</dfn>
-<dd>
-The web content is blended with the real world with additive mixing. Black is fully transparent and white is 100% light. Colors typically add their values to the observed world.
-
-For example: a head-up display in a car.
-
-<dt><dfn>subtractive</dfn>
-<dd>
-The web content is blended with the real world using subtractive mixing. White is fully transparent and dark colors have the most contrast.
-
-For example: an LCD display embedded in a bathroom mirror.
-
-</dl>
-
-Issue: Is there a need for the 'subtractive' value?
-
-<div class="example">
-<pre>
-body { background-color: white; }
-p { color: black; }
-
-@media(environment-blending: additive) {
-  body { background-color: black; }
-  p { color: white; font-size: 16px; font-weight: 1000; }
-}
-</pre>
-</div>
+    <pre class='descdef mq'>
+    Name: environment-blending
+    Value: opaque | additive | subtractive
+    For: @media
+    Type: discrete
+    </pre>
+
+    The 'environment-blending' media feature is used to query the characteristics of the user's display
+    so the author can adjust the style of the document.
+    An author might choose to adjust the visuals and/or layout of the page depending on the display
+    technology to increase the appeal or improve legibility.
+
+    The following values are valid:
+
+    <dl dfn-type=value dfn-for="@media/environment-blending">
+        <dt><dfn>opaque</dfn>
+        <dd>
+            The display is a traditional screen or monitor where there is a completely opaque back panel.
+            Black is dark and white is 100% light.
+
+        <dt><dfn>additive</dfn>
+        <dd>
+            The display blends the colors of the canvas with the real world using additive mixing.
+            Black is fully transparent and white is 100% light.
+
+            For example: a head-up display in a car.
+
+        <dt><dfn>subtractive</dfn>
+        <dd>
+            The display blends the colors of the canvas with the real world using subtractive mixing.
+            White is fully transparent and dark colors have the most contrast.
+
+            For example: an LCD display embedded in a bathroom mirror.
+    </dl>
+
+    Issue: Is there a need for the 'subtractive' value?
+
+    <div class="example">
+        <pre>
+        body { background-color: white; }
+        p { color: black; }
+
+        @media(environment-blending: additive) {
+            body { background-color: black; }
+            p { color: white; font-size: 16px; font-weight: 1000; }
+        }
+        </pre>
+    </div>
 
 
 

From df1ead7ac4e72b4f40cbb59b6aa4f3026de2842a Mon Sep 17 00:00:00 2001
From: Rik Cabanier <rcabanier@mlla2374.magicleap.ds>
Date: Wed, 13 Jun 2018 07:27:45 -0700
Subject: [PATCH 4/4] Included @frivoal's comment

---
 mediaqueries-5/Overview.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mediaqueries-5/Overview.bs b/mediaqueries-5/Overview.bs
index fd1b6602a71..9432ada90c0 100644
--- a/mediaqueries-5/Overview.bs
+++ b/mediaqueries-5/Overview.bs
@@ -168,7 +168,7 @@ Detecting the display technology: the 'environment-blending' feature</h3>
     <dl dfn-type=value dfn-for="@media/environment-blending">
         <dt><dfn>opaque</dfn>
         <dd>
-            The display is a traditional screen or monitor where there is a completely opaque back panel.
+            The document is rendered on an opaque medium, such as a traditional monitor or paper.
             Black is dark and white is 100% light.
 
         <dt><dfn>additive</dfn>