Section 7.2. JWS JSON Serailziation

[ietf@…]

1. As written this section is no understandable. It needs a big re-write

2. Don't care about the comparison statement - If anything it should be reversed and placed in the location where restrictions are placed and not in the general case solution

3. First bullet point can be killed - it is not telling me what to do

4. Second bullet point - This would be much more readable if you did it either as an outdented list or as a table that is of the form - member name, member description. Could also use the same format that you used for header members as well

5. The syntax example should occur before the list of fields so that people see the overview and can then go to the specifics.

6. Define the signatures array and then define the elements that go into that array element.

7. "Unlike the JWS Compact Serialization, in the JWS JSON Serialization" delete all of the - this should just document this serialization and not worry about comparisons

8. Last bullet item goes in the data model description and not the serialization description.

1. the MUST be present in the first sentence belongs in the description of the element and not here

10. There is a difference of opinion if the signature element MUST be present - the bullet point "if non-empty" vs the list of required after the example.

11. It is not clear that the statement that one of protected and header must be present - this is implied since alg must be present.

12. There is no need to state that something is the same as is defined elsewhere

13. The union should be described in the data model and not here

14. What is the purpose of the next to last paragraph here. I cannot follow what this text is trying to say.