Skip to content

Commit 731f37f

Browse files
committed
Added the _why_ of the 3 policies
1 parent 92f52bf commit 731f37f

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

draft-ietf-core-coap-pubsub.md

+12-3
Original file line numberDiff line numberDiff line change
@@ -970,6 +970,8 @@ This document defines parameters used in the messages exchanged between a client
970970

971971
Note that the media type application/core-pubsub+cbor MUST be used when these parameters are transported in the respective message fields.
972972

973+
<!-- To be registerd in IANA: TODO Populate the TBDs non-negative unsigned -->
974+
973975
~~~~~~~~~~~
974976
+----------------------+----------+-----------+------------+
975977
| Name | CBOR Key | CBOR Type | Reference |
@@ -1112,12 +1114,19 @@ The registration policy for the IANA registry established in {{iana-coap-pubsub
11121114

11131115
Expert reviewers should take into consideration the following points:
11141116

1115-
* Clarity and correctness of registrations. Experts are expected to check the clarity of purpose and use of the requested entries. Experts need to make sure that registered parameters are clearly defined in the corresponding specification. Parameters that do not meet these objectives of clarity and completeness must not be registered. Experts should consider requesting an opinion on correctness from the Constrained RESTful Environments (CoRE) Working Group.
1117+
The registration policy for the IANA registry established in {{iana-coap-pubsub-parameters}} is defined as one of "Standards Action with Expert Review", "Specification Required", and "Expert Review". This section gives some general guidelines for what the experts should be looking for; however, they are being designated as experts for a reason, so they should be given substantial latitude.
1118+
1119+
These registration policies are designed to accommodate different use cases; “Standards Action with Expert Review” allows for further IETF standards and extensions, maintaining consistency and alignment with established protocols; “Specification Required” allows third-party specifications from Standards Development Organizations (SDOs) to register parameters, enabling interoperability and broader applicability; and “Expert Review” provides a flexible mechanism for exposing new parameters that implementors do not want to keep in a private range.
1120+
1121+
Expert reviewers should take into consideration the following points:
1122+
1123+
* Clarity and correctness of registrations. Experts are expected to check the clarity of purpose and use of the requested entries. Experts need to make sure that registered parameters are clearly defined in the corresponding specification. Parameters that do not meet these objectives of clarity and completeness must not be registered.
11161124

1117-
* Duplicated registration and point squatting (the use of unregistered code points) should be discouraged. Reviewers should gather enough information to ensure registration requests do not duplicate existing ones and are likely to see deployment. The zones tagged as "Private Use" are intended for testing purposes and closed environments. Code points in other ranges should not be assigned for testing.
1125+
* Point squatting should be discouraged. Reviewers are encouraged to get sufficient information for registration requests to ensure that the usage is not going to duplicate one that is already registered and that the point is likely to be used in deployments. The zones tagged as "Private Use" are intended for testing purposes and closed environments. Code points in other ranges should not be assigned for testing.
11181126

1119-
* Specifications are recommended. When specifications are not provided, the description provided needs to have sufficient information to verify the points above.
1127+
* Specifications are required for the "Standards Action With Expert Review" range of point assignment. Specifications should exist for "Specification Required" ranges, but early assignment before a specification is available is considered to be permissible. When specifications are not provided, the description provided needs to have sufficient information to identify what the point is being used for.
11201128

1129+
* Experts should take into account the expected usage of fields when approving point assignment. Documents published via Standards Action can also register points outside the Standards Action range. The length of the encoded value should be weighed against how many code points of that length are left, the size of device it will be used on, and the number of code points left that encode to that size.
11211130

11221131
--- back
11231132

0 commit comments

Comments
 (0)