[w3c/payment-request] Editorial Fit & Finish Changes (#838)

Editorial changes, though I did have additional editorial comments/questions that I wanted to sanity check in the pull request discussion:

1) There is no mention to the payment handler spec even though handlers are mentioned several times. Should there be a mention in the dependencies or refs section?
2) Why is there both a dependencies and refs section, don't they signify the same thing, especially given the breakdown to normative and informative in the refs section.
3) This is more of an architectural comment, but having the PaymentResponse not be an immutable object (with respect to the retry operation) seems like something we may want to reconsider in favor of immutability and an explicit return value for retry (if we haven't already).
4) The first paragraph after the NOTE block in section 3 (19th page) is incredibly hard to read. I don't have much context on the concept it is describing, so I didn't feel confident I could write an accurate and cleaner sentence.
5) The description of "error" in 6.3 is not very clear. Is it accurate to describe this as a global error message or a fallback error message when a more specific error field is not appropriate?
6) Section 11.4 pulls the term redactList out of nowhere, with no context. Is it fair to say that this is a user agent constructed list of field thought to provide security benefits if redacted?
7) It looks funky that the Assert statements in algorithm sections get their own highlighting box when no other standard term does, is that avoidable?
You can view, comment on, or merge this pull request online at:

  https://github.com/w3c/payment-request/pull/838

-- Commit Summary --

  * Update index.html

-- File Changes --

    M index.html (55)

-- Patch Links --

https://github.com/w3c/payment-request/pull/838.patch
https://github.com/w3c/payment-request/pull/838.diff

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/w3c/payment-request/pull/838