Skip to content

Commit

Permalink
Say "telemetry data" instead of just "information" or "telemetry info…
Browse files Browse the repository at this point in the history
…rmation"
  • Loading branch information
rakuco committed Jun 13, 2024
1 parent 5c966ff commit a2cf3a4
Showing 1 changed file with 13 additions and 12 deletions.
25 changes: 13 additions & 12 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -244,15 +244,15 @@ <h3>Sampling and Reporting Rate</h3>
<section> <h2>Platform primitives</h2>
<p>
A <dfn>pressure source</dfn> is an abstract, [=implementation-defined=]
interface to hardware counters or an underlying telemetry framework that
provides information about a <dfn>source type</dfn>
interface to hardware counters or an underlying framework that provides
telemetry data about a <dfn>source type</dfn>
defined by {{PressureSource}}. A [=pressure source=] can make use of data
fusion with data from additional sources if that provides more precise
results.
</p>
<p>
The telemetry information provided by a [=pressure source=] is represented
in this specification as a <dfn>pressure source sample</dfn>, a [=struct=]
The telemetry data provided by a [=pressure source=] is represented in this
specification as a <dfn>pressure source sample</dfn>, a [=struct=]
consisting of the following [=struct/items=]:
<ul>
<li>
Expand Down Expand Up @@ -298,19 +298,20 @@ <h3>Sampling and Reporting Rate</h3>
</li>
</ul>
<p>
The format of the data provided by a [=pressure source=] is
[=implementation-defined=], and so is the process through which a
[=platform collector=] transforms it into a [=pressure state=].
The format of the telemetry data provided by a [=pressure source=]
and stored in its [=pressure source/latest sample=]'s [=pressure source
sample/data=] is [=implementation-defined=], and so is the process through
which a [=platform collector=] transforms it into a [=pressure state=].
</p>
<p>
For this specification's purposes, [=platform collectors=] are scoped to a
[=global object=] via the [=platform collector mapping=].
</p>
<p>
For automation purposes, a [=platform collector=] must have the ability to
connect to [=virtual pressure sources=] and use their simulated data as
[=pressure states=] rather than raw platform data that must be transformed
into an [=adjusted pressure state=].
connect to [=virtual pressure sources=] and use their simulated [=pressure
source sample/data=] as [=pressure states=] rather than raw platform data
that must be transformed into an [=adjusted pressure state=].
</p>
<p>
As collecting telemetry data often means polling hardware counters, it is not a free operation and thus,
Expand Down Expand Up @@ -692,8 +693,8 @@ <h3>The <dfn>observe()</dfn> method</h3>
<ol>
<li>
Let |realPressureSource| be an [=implementation-defined=]
[=pressure source=] that provides telemetry information
about |source|, or null if none exists.
[=pressure source=] that provides telemetry data about
|source|, or null if none exists.
</li>
<li>
Set |newCollector|'s [=platform collector/associated
Expand Down

0 comments on commit a2cf3a4

Please sign in to comment.