Re: [dxwg] Antoine's conneg doc edits (#575)

@aisaac
As part of ACTION-351 I've reviewed this issue (again) and came to the following conclusions:

Of your original comments, the following can be considered addressed:
Issue | Comment
----- | ----------
1 | OK
2 | OK
3 | OK
8 | OK
9 | OK
10 | OK (the text "The list profiles request MAY be an independent request or part of another realization's request" has been removed)
12 | OK
13 | OK
14 | OK

The following still need to be addressed:
Issue | Proposed Solution
----- | --------------------
4 | Remove reference to IETF ID and #380 from related work (referenced in [§5.1](https://w3c.github.io/dxwg/conneg-by-ap/#related-http)
5, 6 ,7 | Rewrite [§6.1](https://w3c.github.io/dxwg/conneg-by-ap/#abstractmodelcontext). Possibly we should rename it, too: "Context" might not be an appropriate title.
11 | Reference #591 in [§6.2.2](https://w3c.github.io/dxwg/conneg-by-ap/#getresourcebyprofile)
15 | Add/rewrite at least one example that uses a 303 redirect when performing the content negotiation
16 | Rewrite [§7.2](https://w3c.github.io/dxwg/conneg-by-ap/#qsa) to provide a stronger motivation for QSA
17 | Rewrite [§7.2](https://w3c.github.io/dxwg/conneg-by-ap/#qsa): Parts of Antoine's comment have been answered to, but the text now says that QSA is not normative whereas the §7.2 per definitionem _is_ normative since it has no "this section is not normative" clause.
18 | Rewrite [§7.2](https://w3c.github.io/dxwg/conneg-by-ap/#qsa). The text Antoine referred to is still in the document
19 | Rename [example 10](https://w3c.github.io/dxwg/conneg-by-ap/#example-10-requesting-a-list-of-profiles-for-a-resource-by-qsa-in-html) to something along the lines of "Requesting a resource using QSA by giving a list of preferred profiles"

-- 
GitHub Notification of comment by larsgsvensson
Please view or discuss this issue at https://github.com/w3c/dxwg/issues/575#issuecomment-515982929 using your GitHub account

Received on Monday, 29 July 2019 13:05:16 UTC