Skip to content

Commit 4f3e3ef

Browse files
author
ID Bot
committed
Script updating gh-pages from 741323e. [ci skip]
1 parent 6229814 commit 4f3e3ef

2 files changed

Lines changed: 16 additions & 11 deletions

File tree

update-iana-group/draft-ietf-asdf-sdf-protocol-mapping.html

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1444,15 +1444,17 @@ <h4 id="name-property-extension">
14441444
attributes for each direction.<a href="#section-3.1.1-4.2.1" class="pilcrow"></a></p>
14451445
</li>
14461446
</ul>
1447-
<p id="section-3.1.1-5">To extend <code>$$SDF-PROPERTY-PROTOCOL-MAP</code> for a new protocol (e.g.,
1447+
<p id="section-3.1.1-5">To keep these two forms unambiguous, the protocol-specific attribute map
1448+
(the <code>props</code> type) <span class="bcp14">MUST NOT</span> define members named <code>read</code> or <code>write</code>.<a href="#section-3.1.1-5" class="pilcrow"></a></p>
1449+
<p id="section-3.1.1-6">To extend <code>$$SDF-PROPERTY-PROTOCOL-MAP</code> for a new protocol (e.g.,
14481450
"new-protocol"), implementers <span class="bcp14">MUST</span> use the <code>property-protocol-map</code> generic with
1449-
the protocol name and a map type defining the protocol-specific attributes.<a href="#section-3.1.1-5" class="pilcrow"></a></p>
1450-
<p id="section-3.1.1-6">It is to be noted that the protocol <code>name</code> (e.g., "new-protocol") <span class="bcp14">MUST</span> be
1451-
registered in the IANA registry defined in <a href="#iana-prot-map" class="auto internal xref">Section 8.1</a>.<a href="#section-3.1.1-6" class="pilcrow"></a></p>
1452-
<p id="section-3.1.1-7">For example:<a href="#section-3.1.1-7" class="pilcrow"></a></p>
1451+
the protocol name and a map type defining the protocol-specific attributes.<a href="#section-3.1.1-6" class="pilcrow"></a></p>
1452+
<p id="section-3.1.1-7">It is to be noted that the protocol <code>name</code> (e.g., "new-protocol") <span class="bcp14">MUST</span> be
1453+
registered in the IANA registry defined in <a href="#iana-prot-map" class="auto internal xref">Section 8.1</a>.<a href="#section-3.1.1-7" class="pilcrow"></a></p>
1454+
<p id="section-3.1.1-8">For example:<a href="#section-3.1.1-8" class="pilcrow"></a></p>
14531455
<span id="name-example-property-protocol-m"></span><div id="prop-ext-example">
14541456
<figure id="figure-3">
1455-
<div class="lang-cddl sourcecode" id="section-3.1.1-8.1">
1457+
<div class="lang-cddl sourcecode" id="section-3.1.1-9.1">
14561458
<pre>=============== NOTE: '\' line wrapping per RFC 8792 ================
14571459

14581460
$$SDF-PROPERTY-PROTOCOL-MAP //= (
@@ -1470,10 +1472,10 @@ <h4 id="name-property-extension">
14701472
<a href="#name-example-property-protocol-m" class="selfRef">Example Property Protocol Map Extension</a>
14711473
</figcaption></figure>
14721474
</div>
1473-
<p id="section-3.1.1-9">The corresponding JSON in an SDF model looks like:<a href="#section-3.1.1-9" class="pilcrow"></a></p>
1475+
<p id="section-3.1.1-10">The corresponding JSON in an SDF model looks like:<a href="#section-3.1.1-10" class="pilcrow"></a></p>
14741476
<span id="name-example-property-protocol-ma"></span><div id="prop-ext-json-example">
14751477
<figure id="figure-4">
1476-
<div class="lang-json sourcecode" id="section-3.1.1-10.1">
1478+
<div class="lang-json sourcecode" id="section-3.1.1-11.1">
14771479
<pre>{
14781480
"sdfProperty": {
14791481
"temperature": {
@@ -1494,11 +1496,11 @@ <h4 id="name-property-extension">
14941496
<a href="#name-example-property-protocol-ma" class="selfRef">Example Property Protocol Map in JSON</a>
14951497
</figcaption></figure>
14961498
</div>
1497-
<p id="section-3.1.1-11">When a property uses different protocol attributes for read and write
1498-
operations, the mapping can be split:<a href="#section-3.1.1-11" class="pilcrow"></a></p>
1499+
<p id="section-3.1.1-12">When a property uses different protocol attributes for read and write
1500+
operations, the mapping can be split:<a href="#section-3.1.1-12" class="pilcrow"></a></p>
14991501
<span id="name-example-property-protocol-map"></span><div id="prop-ext-rw-json-example">
15001502
<figure id="figure-5">
1501-
<div class="lang-json sourcecode" id="section-3.1.1-12.1">
1503+
<div class="lang-json sourcecode" id="section-3.1.1-13.1">
15021504
<pre>{
15031505
"sdfProperty": {
15041506
"temperature": {

update-iana-group/draft-ietf-asdf-sdf-protocol-mapping.txt

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,9 @@ Table of Contents
232232
* Separate read and write mappings when the protocol uses different
233233
attributes for each direction.
234234

235+
To keep these two forms unambiguous, the protocol-specific attribute
236+
map (the props type) MUST NOT define members named read or write.
237+
235238
To extend $$SDF-PROPERTY-PROTOCOL-MAP for a new protocol (e.g., "new-
236239
protocol"), implementers MUST use the property-protocol-map generic
237240
with the protocol name and a map type defining the protocol-specific

0 commit comments

Comments
 (0)