From 1e31e7c0509ad3f79d349596911d75cb60ff194e Mon Sep 17 00:00:00 2001
From: henbos <hbos@google.com>
Date: Thu, 30 Mar 2023 17:29:07 +0200
Subject: [PATCH] Document recently added audio metrics as features at risk
 (#750)

---
 webrtc-stats.html | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/webrtc-stats.html b/webrtc-stats.html
index a03841d..a7c5e02 100644
--- a/webrtc-stats.html
+++ b/webrtc-stats.html
@@ -2658,6 +2658,9 @@ <h2>
                   produced by the device that got dropped before reaching the
                   media source.
                 </p>
+                <p class="note">
+                  This metric is a feature at risk due to lack of consensus.
+                </p>
               </dd>
               <dt>
                 <dfn>droppedSamplesEvents</dfn> of type <span class=
@@ -2671,6 +2674,9 @@ <h2>
                   increase {{droppedSamplesDuration}} multiple times but is a
                   single dropped samples event.
                 </p>
+                <p class="note">
+                  This metric is a feature at risk due to lack of consensus.
+                </p>
               </dd>
               <dt>
                 <dfn>totalCaptureDelay</dfn> of type <span class=
@@ -2685,6 +2691,9 @@ <h2>
                   used together with {{totalSamplesCaptured}} to calculate the
                   average capture delay per sample.
                 </p>
+                <p class="note">
+                  This metric is a feature at risk due to lack of consensus.
+                </p>
               </dd>
               <dt>
                 <dfn>totalSamplesCaptured</dfn> of type <span class=
@@ -2699,6 +2708,9 @@ <h2>
                   necessarily the same as the frequency of encoders later in the
                   pipeline.
                 </p>
+                <p class="note">
+                  This metric is a feature at risk due to lack of consensus.
+                </p>
               </dd>
             </dl>
           </section>
@@ -2789,6 +2801,10 @@ <h3>
              double             totalPlayoutDelay;
              unsigned long long totalSamplesCount;
 };</pre>
+          <p class="note">
+            The {{RTCAudioPlayoutStats}} dictionary and all of its metrics are
+            features at risk due to lack of consensus.
+          </p>
           <section>
             <h2>
               Dictionary {{RTCAudioPlayoutStats}} Members