[httpapi] Re: [IANA #1387836] expert review for draft-ietf-httpapi-api-catalog (link-relations)

["Kevin Smith, Vodafone" <[e-mail]>]

Hi David,

Many thanks for the feedback - one question regarding:

> (2) I think the use of MUST is too restrictive here because it limits
> evolution over time by establishing a promise that is likely not going
> to be kept - so clients have to prepare for unexpected situations
> either way. I suggest changing it to SHOULD.

I'm not sure which MUST this is referring to, as there is no MUST in either of the 'link relations' sections (3, 8.2). Please would you ask the expert for clarification?

All best,
Kevin



-----Original Message-----
From: David Dong via RT <[e-mail]>
Sent: Wednesday, October 23, 2024 10:42 PM
Cc: [e-mail]; [e-mail]
Subject: [IANA #1387836] expert review for draft-ietf-httpapi-api-catalog (link-relations)

External Email: Do you know the sender? Is the request to open attachments and click links legitimate? If in doubt, use the Report Message button.

Dear Authors/Chairs/ADs,

Please see below for feedback from one of the experts.

Best regards,

David Dong
IANA Services Sr. Specialist

On Tue Oct 22 21:19:45 2024, [e-mail] wrote:
> David,
>
> (1) Regarding the link relation definition
>
> "The link target identifies a catalog of APIs published by the owner
> of the link context."
>
> Since the only relationship between link target and link context is
> this 'ownership' I think it should be more precise what 'owner' means
> - I do not find any definition of owner in the draft. Can you express
> that in a well defined term?
>
> In addition, is there any other relationship beyond 'same owner'
> between link target and context?
>
> (2) I think the use of MUST is too restrictive here because it limits
> evolution over time by establishing a promise that is likely not going
> to be kept - so clients have to prepare for unexpected situations
> either way. I suggest changing it to SHOULD.
>
> Jan
>
>
>
>
>
> > On 22. Oct 2024, at 21:16, David Dong via RT <drafts-expert-review-
> > [e-mail]> wrote:
> >
> > Dear Mark Nottingham, Julian Reschke, Jan Algermissen (cc: httpapi
> > WG),
> >
> > As the designated experts for the Link Relation Types registry, can
> > you review the proposed registration in draft-ietf-httpapi-api-
> > catalog-05 for us? Please see
> >
> > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fda
> > tatracker.ietf.org%2Fdoc%2Fdraft-ietf-httpapi-api-catalog%2F&data=05
> > %7C02%7Ckevin.smith%40vodafone.com%7Cf632d51cc32646ec04e708dcf3ab8b3
> > 1%7C68283f3b84874c86adb3a5228f18b893%7C0%7C0%7C638653165341322357%7C
> > Unknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik
> > 1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&sdata=ckWH5iqS98JramisnLCAOGmy7n3u
> > PNIy%2FDguWey5r8s%3D&reserved=0
> >
> > The due date is November 5th.
> >
> > If this is OK, when the IESG approves the document for publication,
> > we'll make the registration at:
> >
> > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fww
> > w.iana.org%2Fassignments%2Flink-relations%2F&data=05%7C02%7Ckevin.sm
> > ith%40vodafone.com%7Cf632d51cc32646ec04e708dcf3ab8b31%7C68283f3b8487
> > 4c86adb3a5228f18b893%7C0%7C0%7C638653165341868798%7CUnknown%7CTWFpbG
> > Zsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn
> > 0%3D%7C0%7C%7C%7C&sdata=Ok5QebsGlJJs184ORiwHgpHLzVfRSw8sv2GiCCr13M8%
> > 3D&reserved=0
> >
> > Unless you ask us to wait for the other reviewer, we'll act on the
> > first response we receive.
> >
> > With thanks,
> >
> > David Dong
> > IANA Services Sr. Specialist


C2 General