Skip to content

Commit

Permalink
Merge pull request #17 from thomas-fossati/amanda-feedback
Browse files Browse the repository at this point in the history
Amanda feedback
  • Loading branch information
thomas-fossati authored Dec 3, 2024
2 parents d19b343 + 0369f8e commit 56172d3
Showing 1 changed file with 33 additions and 21 deletions.
54 changes: 33 additions & 21 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,55 @@ 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 review described in {{&SELF}}, {{full-checks}} |
| 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.
For the 0-255 range, the DE must also evaluate the requested codepoint concerning the limited availability of the 1-byte codepoint space.
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.

## "Full" Expert Review Checks {#full-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, in addition to the checks described in {{checks}}, 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" Designated Expert review checklist for the CoAP Content-Formats registry consists of the following steps:

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.

0 comments on commit 56172d3

Please sign in to comment.