search

dret / I-D

Internet Drafts I've authored or contributed to.
17 stars 13 forks source link

decide on keeping or removing service-meta link relation in -06 draft #101

Closed dret closed 6 years ago

dret commented 6 years ago

check with @mamund to see whether the service-meta link relation should be kept or removed. it was meant to complement the others for a more general-purpose service metadata format, but it may be too aspirational for now.

mamund commented 6 years ago

i rather like the service-meta link since it offers a kind of "third option" from the human doc (service-doc) and machine doc (service-desc) options.

here are some things i think might be good examples of content for the service-meta link-rel value:

dret commented 6 years ago

On Jul 24, 2018, at 21:19, Mike Amundsen notifications@github.com wrote:

i rather like the service-meta link since it offers a kind of "third option" from the human doc (service-doc) and machine doc (service-desc) options.

here are some things i think might be good examples of content for the service-meta link-rel value:

json schema and/or hyper-schema document (http://json-schema.org/) HAL-FORMS document (https://rwcbook.github.io/hal-forms/) JSON-LD (applied to an existing JSON document)

ok. would it help or even be appropriate to add some language that for something as wide-ranging as service-meta it might be a good idea to use it with some kind of link hint?

mamund commented 6 years ago

link hint? as in HTML type="application/alps+json" or something else?

dret commented 6 years ago

On 2018-07-25 17:52, Mike Amundsen wrote:

link hint? as in HTML |type="application/alps+json"| or something else?

yes, maybe something like that in HTML. in APIs maybe something from @mnot's link hint idea (or my similar earlier idea to do pretty much the same). link hints will depend on the context of the relation. all i wanted to say is that additional information regarding the nature of the linked resource may be helpful, given the wide scope of service-meta.

dret commented 6 years ago

https://tools.ietf.org/html/draft-wilde-service-link-rel-06 is published now, please feel free to review the minor addition in terms of mentioning the link hint idea. if that's fine, i am assuming we can close this issue.

mamund commented 6 years ago

looks fine -- you can close this one out, too.

On Thu, Aug 2, 2018 at 3:42 AM Erik Wilde notifications@github.com wrote:

https://tools.ietf.org/html/draft-wilde-service-link-rel-06 is published now, please feel free to review the minor addition in terms of mentioning the link hint idea. if that's fine, i am assuming we can close this issue.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/dret/I-D/issues/101#issuecomment-409680194, or mute the thread https://github.com/notifications/unsubscribe-auth/AACVyARAXEtLpJRH-lUZ6Qs5m5WpPXh1ks5uMfaXgaJpZM4VRcEo .