Skip to content

Commit

Permalink
Deploying to gh-pages from @ 25480a0 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
rofrankel committed Oct 6, 2023
1 parent b7336ab commit 56c2011
Show file tree
Hide file tree
Showing 21 changed files with 198 additions and 198 deletions.
152 changes: 76 additions & 76 deletions 1.html

Large diffs are not rendered by default.

10 changes: 5 additions & 5 deletions 126.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item nav-item-active">
Expand Down Expand Up @@ -445,7 +445,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
</div>
<h2 id="further-reading">Further reading</h2>
<ul>
<li>For states, a special type of enum, see AIP-216.</li>
<li>For states, a special type of enum, see <a href="/216">AEP-216</a>.</li>
</ul>
<footer>
Except as otherwise noted, the content of this page is licensed under the
Expand Down
18 changes: 9 additions & 9 deletions 131.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item">
Expand Down Expand Up @@ -316,7 +316,7 @@ <h2 id="guidance">Guidance</h2>
valuable for users to do so. When the <code>GET</code> method is used on a URI ending in a
resource ID or resource ID alias, the result should be a single resource. For
more information about using the <code>GET</code> method on a URI ending with a resource
collection identifier, see AIP-132.</p>
collection identifier, see <a href="/132">AEP-132</a>.</p>
<h3 id="requests">Requests</h3>
<p>Single-resource <code>GET</code> operations <strong>must</strong> be made by sending a <code>GET</code> request to
the resource's URI:</p>
Expand All @@ -336,7 +336,7 @@ <h3 id="requests">Requests</h3>
</li>
<li>The request <strong>must not</strong> require any fields in the query string. The request
<strong>should not</strong> include optional fields in the query string unless described
in another AIP.</li>
in another AEP.</li>
</ul>
<h3 id="responses">Responses</h3>
<p>Single-resource <code>GET</code> operations <strong>must</strong> return the resource itself, without
Expand Down Expand Up @@ -376,7 +376,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
<li>The response message <strong>must</strong> be the resource itself. (There is no
<code>GetBookResponse</code>.)<ul>
<li>The response <strong>should</strong> usually include the fully-populated resource unless
there is a reason to return a partial response (see AIP-157).</li>
there is a reason to return a partial response (see <a href="/157">AEP-157</a>).</li>
</ul>
</li>
<li>The HTTP verb <strong>must</strong> be <code>GET</code>.</li>
Expand Down Expand Up @@ -413,7 +413,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
<li>The comment for the <code>name</code> field <strong>should</strong> document the resource pattern.</li>
<li>The request message <strong>must not</strong> contain any other required fields, and
<strong>should not</strong> contain other optional fields except those described in
another AIP.</li>
another AEP.</li>
</ul>
<p><strong>Note:</strong> The <code>name</code> field in the request object corresponds to the <code>name</code>
variable in the <code>google.api.http</code> annotation on the RPC. This causes the <code>name</code>
Expand Down Expand Up @@ -442,7 +442,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
<li>The response content <strong>must</strong> be the resource itself. For example:
<code>#/components/schemas/Book</code><ul>
<li>The response <strong>should</strong> usually include the fully-populated resource unless
there is a reason to return a partial response (see AIP-157).</li>
there is a reason to return a partial response (see <a href="/157">AEP-157</a>).</li>
</ul>
</li>
<li>The URI <strong>should</strong> contain a variable for each individual ID in the resource
Expand Down
20 changes: 10 additions & 10 deletions 132.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item">
Expand Down Expand Up @@ -318,7 +318,7 @@ <h2 id="guidance">Guidance</h2>
unless it is not valuable for users to do so. When the <code>GET</code> method is used on
a URI ending in a resource collection, the result should be a list of
resources. For more information about using the <code>GET</code> method on a URI ending
with a discrete resource ID, see AIP-131.</p>
with a discrete resource ID, see <a href="/131">AEP-131</a>.</p>
<h3 id="requests">Requests</h3>
<p>Collection <code>GET</code> operations <strong>must</strong> be made by sending a <code>GET</code> request to the
resource collection's URI:</p>
Expand Down Expand Up @@ -373,7 +373,7 @@ <h3 id="responses">Responses</h3>
<li>The <code>string nextPageToken</code> field <strong>must</strong> be included in the list response
schema. It <strong>must</strong> be set if there are subsequent pages, and <strong>must not</strong> be
set if the response represents the final page. For more information, see
AIP-158.</li>
<a href="/158">AEP-158</a>.</li>
<li>The response struct <strong>may</strong> include a <code>int32 totalSize</code> (or
<code>int64 totalSize</code>) field with the number of items in the collection.<ul>
<li>The value <strong>may</strong> be an estimate (the field <strong>should</strong> clearly document
Expand Down Expand Up @@ -418,7 +418,7 @@ <h3 id="ordering">Ordering</h3>
<h3 id="filtering">Filtering</h3>
<p>List methods <strong>may</strong> allow clients to specify filters; if they do, the request
message <strong>should</strong> contain a <code>string filter</code> field. Filtering is described in
more detail in AIP-160.</p>
more detail in <a href="/160">AEP-160</a>.</p>
<p><strong>Note:</strong> Only include filtering if there is an established need to do so. It
is always possible to add filtering later, but removing it is a breaking
change.</p>
Expand Down Expand Up @@ -446,7 +446,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
<li>The request message <strong>must</strong> match the RPC name, with a <code>-Request</code> suffix.</li>
<li>The response message <strong>must</strong> match the RPC name, with a <code>-Response</code> suffix.<ul>
<li>The response <strong>should</strong> usually include fully-populated resources unless
there is a reason to return a partial response (see AIP-157).</li>
there is a reason to return a partial response (see <a href="/157">AEP-157</a>).</li>
</ul>
</li>
<li>The HTTP verb <strong>must</strong> be <code>GET</code>.</li>
Expand Down Expand Up @@ -492,7 +492,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
</li>
<li>The <code>max_page_size</code> and <code>page_token</code> fields, which support pagination,
<strong>must</strong> be specified on all list request messages. For more information, see
AIP-158.</li>
<a href="/158">AEP-158</a>.</li>
</ul>
<p><strong>Note:</strong> The <code>parent</code> field in the request object corresponds to the <code>parent</code>
variable in the <code>google.api.http</code> annotation on the RPC. This causes the
Expand Down Expand Up @@ -561,7 +561,7 @@ <h2 id="interface-definitions">Interface Definitions</h2>
<li>The response content <strong>must</strong> be the resource itself. For example:
<code>#/components/schemas/Book</code><ul>
<li>The response <strong>should</strong> usually include the fully-populated resource unless
there is a reason to return a partial response (see AIP-157).</li>
there is a reason to return a partial response (see <a href="/157">AEP-157</a>).</li>
</ul>
</li>
<li>The URI <strong>should</strong> contain a variable for each individual ID in the resource
Expand Down
10 changes: 5 additions & 5 deletions 136.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item">
Expand Down Expand Up @@ -535,7 +535,7 @@ <h3 id="stateless-operations">Stateless operations</h3>
<h3 id="declarative-friendly-resources">Declarative-friendly resources</h3>
<p>Declarative-friendly resources usually <strong>should not</strong> employ custom operations
(except specific declarative-friendly custom operations discussed in other
AIPs), because declarative-friendly tools are unable to automatically determine
AEPs), because declarative-friendly tools are unable to automatically determine
what to do with them.</p>
<p>An exception to this is for rarely-used, fundamentally imperative operations,
such as a <code>Move</code>, <code>Rename</code>, or <code>Restart</code> operation, for which there would not
Expand Down
8 changes: 4 additions & 4 deletions 141.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item">
Expand Down
8 changes: 4 additions & 4 deletions 142.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item">
Expand Down
12 changes: 6 additions & 6 deletions 144.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&amp;lang=en" rel="stylesheet"></link>
<link rel="shortcut icon" href="/assets/favicon.ico">
<link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=df0881fc">
<link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b27cc4d7">
<link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b27cc4d7">
<script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script>
<script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script>
<script type="text/javascript">
Expand All @@ -18,7 +18,7 @@
$('html').css('visibility', 'visible');
});
</script>
<script type="text/javascript" src="/assets/js/global.js?v=df0881fc"></script>
<script type="text/javascript" src="/assets/js/global.js?v=b27cc4d7"></script>

<script type="text/javascript" src="/assets/js/syntax.js"></script>

Expand Down Expand Up @@ -154,7 +154,7 @@
<li class="nav-item">
<a href="/1">
<span class="aep-number">1</span>
AIP Purpose and Guidelines
AEP Purpose and Guidelines
</a>
</li>
<li class="nav-item">
Expand Down Expand Up @@ -360,7 +360,7 @@ <h3 id="update-strategies">Update strategies</h3>
back. This is fine for many situations, particularly when the array field is
expected to have a small size (fewer than 10 or so) and race conditions are not
an issue, or can be guarded against with [ETags][aip-154].</p>
<p><strong>Note:</strong> Declarative-friendly resources (AIP-128) <strong>must</strong> use the standard
<p><strong>Note:</strong> Declarative-friendly resources (<a href="/128">AEP-128</a>) <strong>must</strong> use the standard
<code>Update</code> method, and not introduce <code>Add</code> and <code>Remove</code> methods. If declarative
tools need to reason about particular relationships while ignoring others,
consider using a subresource instead.</p>
Expand Down Expand Up @@ -526,7 +526,7 @@ <h4 id="request-structure">Request Structure</h4>
</li>
<li>The request message <strong>must not</strong> contain any other required fields, and
<strong>should not</strong> contain other optional fields except those described in this
or another AIP.</li>
or another AEP.</li>
</ul>
</div>
<input id="__tabbed_2_2" name="__tabbed_2" type="radio" /><label for="__tabbed_2_2">OpenAPI 3.0</label><div class="tabbed-content">
Expand Down
Loading

0 comments on commit 56c2011

Please sign in to comment.