From cb3a5b0831535924e753a87d2a9685f1e5ddf12a Mon Sep 17 00:00:00 2001
From: Joshua Bell <jsbell@chromium.org>
Date: Thu, 14 Mar 2024 06:39:21 +0000
Subject: [PATCH] Content: Clarify the expected behavior for axes being empty
 (#599)

SHA: 048e85507e94050b4806e0e7a3494b72d81b9ab0
Reason: push, by fdwr

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 index.html | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/index.html b/index.html
index 78831309..38a1bdee 100644
--- a/index.html
+++ b/index.html
@@ -7,7 +7,7 @@
   <link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
   <meta content="Bikeshed version 82ce88815, updated Thu Sep 7 16:33:55 2023 -0700" name="generator">
   <link href="https://www.w3.org/TR/webnn/" rel="canonical">
-  <meta content="09b471d8d6fcd68267d77408e0897c9ceae96969" name="document-revision">
+  <meta content="048e85507e94050b4806e0e7a3494b72d81b9ab0" name="document-revision">
 <style>
 /* Make <dl> blocks more distinct from their surroundings. */
 main dl:not(.switch) {
@@ -2364,7 +2364,7 @@ <h4 class="heading settled" data-level="7.8.5" id="api-mlgraphbuilder-argminmax"
    <dl>
     <dt data-md><dfn class="dfn-paneled idl-code" data-dfn-for="MLArgMinMaxOptions" data-dfn-type="dict-member" data-export id="dom-mlargminmaxoptions-axes"><code>axes</code></dfn>, <span> of type <code class="idl-code">sequence&lt;[EnforceRange] unsigned long></code></span>
     <dd data-md>
-     <p>The dimensions to reduce. The values must be in the range [0, N-1] where N is the <a data-link-type="dfn" href="#mloperand-rank" id="ref-for-mloperand-rank">rank</a> of the input tensor. If not present, all dimensions are reduced.</p>
+     <p>The dimensions to reduce. The values must be in the range [0, N-1] where N is the <a data-link-type="dfn" href="#mloperand-rank" id="ref-for-mloperand-rank">rank</a> of the input tensor. If not present, all dimensions are reduced. If empty, no dimensions are reduced, and the shape of the output tensor is the same as the shape of the input tensor.</p>
     <dt data-md><dfn class="dfn-paneled idl-code" data-dfn-for="MLArgMinMaxOptions" data-dfn-type="dict-member" data-export id="dom-mlargminmaxoptions-keepdimensions"><code>keepDimensions</code></dfn>, <span> of type <a data-link-type="idl-name" href="https://webidl.spec.whatwg.org/#idl-boolean" id="ref-for-idl-boolean②">boolean</a>, defaulting to <code>false</code></span>
     <dd data-md>
      <p>If true, retains reduced dimensions with <a data-link-type="dfn" href="https://infra.spec.whatwg.org/#list-size" id="ref-for-list-size②">size</a> 1.</p>
@@ -5095,7 +5095,7 @@ <h4 class="heading settled" data-level="7.8.24" id="api-mlgraphbuilder-layernorm
      <p>The N-D tensor of the bias values whose shape is determined by the <var>axes</var> member in that each value in <var>axes</var> indicates the dimension of the input tensor with bias values. For example, for an <var>axes</var> values of [1,2,3], the shape of this tensor is the list of the corresponding sizes of the input dimension 1, 2 and 3. When this member is not present, the bias value is assumed to be 0.</p>
     <dt data-md><dfn class="dfn-paneled idl-code" data-dfn-for="MLLayerNormalizationOptions" data-dfn-type="dict-member" data-export id="dom-mllayernormalizationoptions-axes"><code>axes</code></dfn>, <span> of type <code class="idl-code">sequence&lt;[EnforceRange] unsigned long></code></span>
     <dd data-md>
-     <p>The indices to the input dimensions to reduce. When this member is not present, it is treated as if all dimensions except the first were given (e.g. for a 4-D input tensor, axes = [1,2,3]). That is, the reduction for the mean and variance values are calculated across all the input features for each independent batch.</p>
+     <p>The indices to the input dimensions to reduce. When this member is not present, it is treated as if all dimensions except the first were given (e.g. for a 4-D input tensor, axes = [1,2,3]). That is, the reduction for the mean and variance values are calculated across all the input features for each independent batch. If empty, no dimensions are reduced.</p>
     <dt data-md><dfn class="dfn-paneled idl-code" data-dfn-for="MLLayerNormalizationOptions" data-dfn-type="dict-member" data-export id="dom-mllayernormalizationoptions-epsilon"><code>epsilon</code></dfn>, <span> of type <a data-link-type="idl-name" href="https://webidl.spec.whatwg.org/#idl-float" id="ref-for-idl-float②⑥">float</a>, defaulting to <code>1e-5</code></span>
     <dd data-md>
      <p>A small value to prevent computational error due to divide-by-zero.</p>
@@ -6496,7 +6496,7 @@ <h4 class="heading settled" data-level="7.8.33" id="api-mlgraphbuilder-reduce"><
    <dl>
     <dt data-md><dfn class="dfn-paneled idl-code" data-dfn-for="MLReduceOptions" data-dfn-type="dict-member" data-export id="dom-mlreduceoptions-axes"><code>axes</code></dfn>, <span> of type <code class="idl-code">sequence&lt;[EnforceRange] unsigned long></code></span>
     <dd data-md>
-     <p>The dimensions to reduce. The values in the list must be in the range [0, N-1] where N is the <a data-link-type="dfn" href="#mloperand-rank" id="ref-for-mloperand-rank⑤⑤">rank</a> of the input tensor. If not present, all dimensions are reduced.</p>
+     <p>The dimensions to reduce. The values in the list must be in the range [0, N-1] where N is the <a data-link-type="dfn" href="#mloperand-rank" id="ref-for-mloperand-rank⑤⑤">rank</a> of the input tensor. If not present, all dimensions are reduced. If empty, no dimensions are reduced, and the shape of the output tensor is the same as the shape of the input tensor.</p>
     <dt data-md><dfn class="dfn-paneled idl-code" data-dfn-for="MLReduceOptions" data-dfn-type="dict-member" data-export id="dom-mlreduceoptions-keepdimensions"><code>keepDimensions</code></dfn>, <span> of type <a data-link-type="idl-name" href="https://webidl.spec.whatwg.org/#idl-boolean" id="ref-for-idl-boolean①⑨">boolean</a>, defaulting to <code>false</code></span>
     <dd data-md>
      <p>If true, retains reduced dimensions with <a data-link-type="dfn" href="https://infra.spec.whatwg.org/#list-size" id="ref-for-list-size④⓪">size</a> 1.</p>