ietf-wg-httpapi / linkset

Media Types and a Link Relation Type for Link Sets
https://datatracker.ietf.org/doc/draft-ietf-httpapi-linkset/
7 stars 8 forks source link

Limiting forms of extensibility #54

Closed darrelmiller closed 3 years ago

darrelmiller commented 3 years ago

https://github.com/ietf-wg-httpapi/linkset/blob/8423856c13e64b54ba547b9971edf51200ccd2e4/draft-ietf-httpapi-linkset-04.txt#L775-L777

I struggled with comprehending this sentence. After reading the comments in #8 I think I understand the intent of the paragraph. Like Julian, I struggled with "the JSON syntax". I was also confused by the phrase "additional members of the LinkSet member". Today I learned that that RFC8259 uses the term member!

I wonder it could be clearer with a simpler, more blanket statement like:

The Web linking model ([RFC8288]) provides for the use of extension target attributes as discussed in Section 4.2.4.3. No other form of extensions SHOULD be used. In case they are used nevertheless, ...

hvdsomp commented 3 years ago

Addressed. Closing.