Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Amanda feedback #17

Merged
merged 5 commits into from
Dec 3, 2024
Merged
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 30 additions & 20 deletions draft-fossati-core-cf-reg-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,9 @@ informative:
Err4954: 7252
RFC9193: senml-cf

entity:
SELF: "RFCthis"

--- abstract

This document updates the registration procedures for the "CoAP Content-Formats" registry, within the "CoRE Parameters" registry group, defined in Section 12.3 of RFC7252.
Expand Down Expand Up @@ -114,46 +117,53 @@ Other than that, it does not change the Security Considerations of {{-coap}}.

# IANA Considerations {#iana}

## Expert Review with Expert Check "FCFS+"

This document introduces the term "Expert Review (Expert Check: FCFS+)" to describe a registration policy that would typically have been handled as FCFS, except the approval checklist is complex enough to require advice from a DE.
Such policy can be viewed as a "lightweight" form of the "full" Expert Review.

A protocol that requires "Expert Check: FCFS+" for registration of its parameters MUST specify what the FCFS+ checks entail.
The CoAP Content-Formats registration procedures defined in {{Section 12.3 of -coap}} are modified as shown in {{tbl-new-cf-proc}}.

## CoAP Content-Formats Registration Procedures Update

The CoAP Content-Formats registration procedures defined in {{Section 12.3 of -coap}} are modified to transition the 10000-64999 range from FCFS to "Expert Review (Expert Check: FCFS+)", with the FCFS+ checklist described in {{checks}}.

| Range | Registration Procedures |
| Range | Registration Procedures | Note |
|--------|--------|
| 0-255 | Expert Review (Full) |
| 256-9999 | IETF Review or IESG Approval |
| 10000-64999 | Expert Review (Expert Check: FCFS+) |
| 0-255 | Expert Review (Full) | |
EskoDijk marked this conversation as resolved.
Show resolved Hide resolved
| 256-9999 | IETF Review or IESG Approval | |
| 10000-64999 (No parameters and empty Content Coding and media type not yet used in this registry) | First Come First Served | Corresponding media type registration required |
| 10000-64999 (Includes parameters and/or Content Coding) | Expert Review | Lightweight review described in {{&SELF}}, {{checks}} |
| 65000-65535 | Experimental use (no operational use) |
{: #tbl-new-cf-proc title="Updated CoAP Content-Formats Registration Procedures"}

The registration procedure for the 0-255 range has been slightly modified -- from "Expert Review" to "Expert Review (Full)" -- to clearly distinguish it from the policy that applies to the 10000-64999 range.
The 10000-64999 range now has two separate registration procedures.
If the registration consists solely of a registered media type name in the "Content Type" field, without any parameter names or "Content Coding", and the media type has not yet been used in this registry, then the policy is FCFS, as before.
In all other cases, the policy will be Expert Review, following the checklist described in {{checks}}.

A new column with the title "Note" has been added to the registry, which contains information about expected checks.

The registration procedure for the 0-255 range has been slightly modified -- from "Expert Review" to "Expert Review (Full)" -- to clearly distinguish it from the "lightweight" Expert Review that may apply to the 10000-64999 range.
For the 0-255 range, the DE must also evaluate the requested codepoint concerning the limited availability of the 1-byte codepoint space.
For the 10000-64999 range, this criterion does not apply.

### FCFS+ Checks {#checks}
## "Lightweight" Expert Review Checks {#checks}

The "Expert Check: FCFS+" checklist for the CoAP Content-Formats registry consist of the following steps:
The "lightweight" DE review checklist for the CoAP Content-Formats registry consists of the following steps:
thomas-fossati marked this conversation as resolved.
Show resolved Hide resolved

1. The combination of content-type and content coding for which the registration is requested must not be already present in the "CoAP Content-Formats" registry;
1. The media type associated with the requested Content-Format must exist in the "Media Types" registry {{?IANA.media-types}}, or IANA has approved its registration;
1. The media type associated with the requested Content-Format must exist (or must have been approved for registration) in the "Media Types" registry {{?IANA.media-types}};
1. The optional parameter names must exist in association with the media type, and any parameter values associated with such parameter names are as expected;
1. If a Content Coding is specified, it must exist in the "HTTP Content Coding Registry" of the "Hypertext Transfer Protocol (HTTP) Parameters" {{?IANA.http-parameters}}, or IANA has approved its registration.
1. If a Content Coding is specified, it must exist (or must have been approved for registration) in the "HTTP Content Coding Registry" of the "Hypertext Transfer Protocol (HTTP) Parameters" {{?IANA.http-parameters}}.

## Temporary Note Removal

The following note has been added to the registry as a temporary fix:

> "Note: The validity of the combination of Content Coding, Content Type and parameters is checked prior to assignment."

IANA is instructed to remove it when the this document is approved for publication.

--- back

# Acknowledgments
{:numbered="false"}

Thank you
Amanda Baber,
Carsten Bormann,
Francesca Palombini
and
Marco Tiloca
for your reviews and comments.
for your reviews, comments, suggestions and fixes.