From f6e72c5bd9afc4774f11a12171725910936a4c20 Mon Sep 17 00:00:00 2001
From: Douglas Creager <dcreager@dcreager.net>
Date: Mon, 9 Jul 2018 08:51:56 -0400
Subject: [PATCH] Clarify name of "observability" property (#101)

In w3c/network-error-logging#77 there was some confusion about what
"observable from JavaScript" means.  The intended meaning is very
specific: the report will not be handed off to any registered
`ReportingObserver`s.  Another reading that is you can perform whatever
complicated analysis you want, and somehow detect that a report was
created.  This patch renames the term to something that hopefully can
only be read in the more specific way.
---
 index.src.html | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/index.src.html b/index.src.html
index 8d83edd..5c646bc 100644
--- a/index.src.html
+++ b/index.src.html
@@ -314,10 +314,10 @@ <h3 id="concept-report-type">Report Type</h3>
   that is contained in the [=report/body=] of a <a>report</a>.
 
   When a <a>report type</a> is defined (in this spec or others), it can be
-  specified to be <dfn>observable from JavaScript</dfn>, meaning
+  specified to be <dfn>visible to <code>ReportingObserver</code>s</dfn>, meaning
   that <a>reports</a> of that type can be observed by a <a>reporting
-  observer</a>. By default, <a>report types</a> are not <a>observable from
-  JavaScript</a>.
+    observer</a>. By default, <a>report types</a> are not <a>visible to
+    <code>ReportingObserver</code>s</a>.
 
   Note: See [[#deprecation-report]] as an example <a>report type</a> definition.
 
@@ -1084,8 +1084,8 @@ <h3 id="add-report" algorithm>
   algorithm adds |report| to |observer|'s <a>report list</a>, so long as
   |report|'s <a>type</a> is observable by |observer|.
 
-  1. If |report|'s [=report/type=] is not <a>observable from JavaScript</a>,
-     return.
+  1. If |report|'s [=report/type=] is not <a>visible to
+    <code>ReportingObserver</code>s</a>, return.
 
   2. If |observer|'s <a>options</a> has a non-empty
      {{ReportingObserverOptions/types}} member which does not contain |report|'s
@@ -1135,7 +1135,8 @@ <h3 id="deprecation-report">Deprecation</h3>
 
   <a>Deprecation reports</a> have the <a>report type</a> "deprecation".
 
-  <a>Deprecation reports</a> are <a>observable from JavaScript</a>.
+  <a>Deprecation reports</a> are <a>visible to
+  <code>ReportingObserver</code>s</a>.
 
   <pre class="idl">
     interface DeprecationReportBody : ReportBody {
@@ -1190,7 +1191,8 @@ <h3 id="intervention-report">Intervention</h3>
 
   <a>Intervention reports</a> have the <a>report type</a> "intervention".
 
-  <a>Intervention reports</a> are <a>observable from JavaScript</a>.
+  <a>Intervention reports</a> are <a>visible to
+  <code>ReportingObserver</code>s</a>.
 
   <pre class="idl">
     interface InterventionReportBody : ReportBody {