Skip to content

Commit ada220e

Browse files
committed
review: rework some text, fix some grammar, and remove BCP14 words, close #142
1 parent f5df1a0 commit ada220e

1 file changed

Lines changed: 9 additions & 10 deletions

File tree

draft-ietf-anima-rfc8366bis.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1146,28 +1146,27 @@ The name is: Voucher Extensions, and the Registration Policy is Expert Review.
11461146
> Extension SID:
11471147
> : the YANG module SID value that defines the extension per {{voucher-ext}}.
11481148

1149-
Each extension MUST follow the rules specified in this specification.
1150-
11511149
Note that the SID module value is allocated as part of a {{CORESID}} process.
11521150
This may be from a SID range managed by IANA, or from any other MegaRange.
1153-
Future work may allow for PEN based allocations.
1151+
{{?RFC9997}} allows for PEN based allocations.
11541152
IANA does not need to separately allocate a SID value for this column.
11551153

1156-
Extension name strings for standards track documents are single words, given by the YANG Module Name. They do not contain dots.
1154+
Extension name strings for IETF process (standards track, experimental, IRTF) documents are single words, given by the YANG Module Name: They do not contain dots.
11571155

1158-
For vendor proprietary extensions, the string SHOULD be made unique by putting the extension name in the form a fully-qualified domain name (FQDN) {{?RFC3696}}, such as "fuubar.example.com"
1156+
For vendor proprietary extensions, (including ISE submissions), the resulting string still needs to be unique.
1157+
This can be done by putting the extension name in the form a fully-qualified domain name (FQDN) {{?RFC3696}}, such as "fuubar.example.com"
11591158

1160-
Vendor proprietary extensions do not need to be registered with IANA, but vendors MAY do so.
1159+
Vendor proprietary extensions do not need to be registered with IANA, but vendors are encouraged to do so.
11611160

1162-
Designated Experts should review for standards track documents for clarity, but the choices are tied to WG and IESG processes:
1161+
Designated Experts should review the documents for clarity, but the choices are tied to WG and IESG processes:
11631162

11641163
* There are no choices in the extension names (which is always the YANG module name), or SID value (which is from another IANA process).
11651164

1166-
* For non-standards track extensions, the Designated Expert should review whatever document is provided, if any.
1165+
* For non-standards track extensions, the Designated Expert should review the provided document is provided for clarity of purpose.
11671166
The stability of the reference may be of concern.
11681167

1169-
The Designated Expert should determine if the work overlaps with existing efforts; and if so suggest merging/coordinating.
1170-
However, as registration is optional, the Designated Expert should not block any vendor registrations.
1168+
The Designated Expert should determine if the work overlaps with an existing IETF WG effort, suggesting ways that the work could become part of a standard.
1169+
However, as registration is optional, the Designated Expert should not block any vendor registrations if no consolidated extension is possible.
11711170

11721171
## The IETF YANG-SID Ranges Registry
11731172

0 commit comments

Comments
 (0)