Skip to main content

Shepherd writeup
draft-ietf-core-links-json

Proper rendering at:
http://jaimejim.github.io/temp/draft-ietf-core-links-json#shepherd-writeup

###Summary

Document Shepherd: Jaime Jiménez, <jaime.jimenez@ericsson.com>
Area Director: Alexey Melnikov, <aamelnikov@fastmail.fm>

JavaScript Object Notation, JSON (RFC7159) is a text-based data format which is
popular for Web based data exchange.  Concise Binary Object Representation,
CBOR (RFC7049) is a binary data format which has been optimized for data
exchange for the Internet of Things (IoT). For many IoT scenarios, CBOR formats
will be preferred since it can help decrease transmission payload sizes as well
as implementation code sizes compared to other data formats.

Web Linking (RFC5988) provides a way to represent links between Web resources
as well as the relations expressed by them and attributes of such a link. In
constrained networks, a collection of Web links can be exchanged in the CoRE
link format (RFC6690). Outside of constrained environments, it may be useful to
represent these collections of Web links in JSON, and similarly, inside
constrained environments, in CBOR. This specification defines a common format
for this.

The document is intended for Standards Track.

###Review and Consensus

The document has gone through multiple expert reviews and has been discussed on
multiple IETF meetings. Before the last IETF the WGLC was completed.

###Intellectual Property

Each author has stated that they do not have direct, personal knowledge of any
IPR related to this document. I am not aware of any IPR discussion about this
document on the CoRE WG.

###Other Points

IMO the title should probably be: "Representing CoRE link-format in JSON and
CBOR". A previous version included other formats, the present one doesn’t.

###Checklist

* [x] Does the shepherd stand behind the document and think the document is
ready for publication? * [x] Is the correct RFC type indicated in the title
page header? * [x] Is the abstract both brief and sufficient, and does it stand
alone as a brief summary? * [x] Is the intent of the document accurately and
adequately explained in the introduction? * [x] Have all required formal
reviews (MIB Doctor, Media Type, URI, etc.) been requested and/or completed?
`Mail sent to media-types@iana.org, waiting for anwer. New entries
(link-format+json and link-format+cbor) need verification by
media-types@iana.org.` * [x] Has the shepherd performed automated checks --
idnits (see http://www.ietf.org/tools/idnits/ and the Internet-Drafts
Checklist), checks of BNF rules, XML code and schemas, MIB definitions, and so
on -- and determined that the document passes the tests?
`draft-greevenbosch-appsawg-cbor-cddl-09 ref should be updated` * [x] Has each
author stated that their direct, personal knowledge of any IPR related to this
document has already been disclosed, in conformance with BCPs 78 and 79? * [x]
Have all references within this document been identified as either normative or
informative, and does the shepherd agree with how they have been classified?
`Both seem correct to me` * [x] Are all normative references made to documents
that are ready for advancement and are otherwise in a clear state? * [x] If
publication of this document changes the status of any existing RFCs, are those
RFCs listed on the title page header, and are the changes listed in the
abstract and discussed (explained, not just mentioned) in the introduction?
`Does not apply` * [x] If this is a "bis" document, have all of the errata been
considered? `Does not apply`

* **IANA** Considerations:

        * [x] Are the IANA Considerations clear and complete? Remember that
        IANA have to understand unambiguously what's being requested, so they
        can perform the required actions. `TBD64 and TBD54 are the requested
        numbers, as shown on Table 2.` * [x] Are all protocol extensions that
        the document makes associated with the appropriate reservations in IANA
        registries? * [x] Are all IANA registries referred to by their exact
        names (check them in http://www.iana.org/protocols/ to be sure)? * [x]
        Have you checked that any registrations made by this document correctly
        follow the policies and procedures for the appropriate registries? *
        [x] For registrations that require expert review (policies of Expert
        Review or Specification Required), have you or the working group had
        any early review done, to make sure the requests are ready for last
        call? * [x] For any new registries that this document creates, has the
        working group actively chosen the allocation procedures and policies
        and discussed the alternatives? `no new registries` * [x]  Have
        reasonable registry names been chosen (that will not be confused with
        those of other registries), and have the initial contents and valid
        value ranges been clearly specified?
Back