dret / I-D

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

Add example to section 4.2.4 of LinkSets spec #83

Closed mamund closed 6 years ago

mamund commented 7 years ago

reading through the rules of how extension attributes are expressed is a bit gnarly. would be good to see one or more actual examples that show which extensions MUST use arrays, which not, etc.

https://github.com/dret/I-D/blob/master/linkset/draft-wilde-linkset-01.txt#L512

dret commented 7 years ago

On Sep 6, 2017, at 15:48, Mike Amundsen notifications@github.com wrote:

reading through the rules of how extension attributes are expressed is a bit gnarly. would be good to see one or more actual examples that show which extensions MUST use arrays, which not, etc.

all extension attributes must be arrays because every extension attribute may be allowed to repeat. we'll look into where might be a good spot to add examples.

mamund commented 7 years ago

Understood.

I got a big confused about arrays when reading points three and four on that list. That's where an example would be handy, I think.

dret commented 7 years ago

please have a look at the first proposal to resolve this issue. please be aware that it's in the -02 files, because -01 has been published.

hvdsomp commented 7 years ago

I like the addition of this example.

I was also wondering whether it would be helpful to add the "rules" that guide the serialization decisions at the outset of the JSON section. I mean by this something like the bullet list under "Overall serialization approach" in #80

dret commented 7 years ago

if the proposed example is good enough, please feel free to close this issue.

hvdsomp commented 6 years ago

This one is done.