Skip to content

Commit 0975d2b

Browse files
authored
Merge the HTTP guidance into the "consult other specs" section. (#546)
* Merge the HTTP guidance into the "consult other specs" section. * Preserve the old ID.
1 parent b4e7086 commit 0975d2b

File tree

1 file changed

+7
-26
lines changed

1 file changed

+7
-26
lines changed

index.bs

+7-26
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ Markup Shorthands: markdown on
2020
Boilerplate: feedback-header off
2121
!By: <a href="https://www.w3.org/2001/tag/">Members of the TAG</a>, past and present
2222
!Participate: <a href="https://github.com/w3ctag/design-principles">GitHub w3ctag/design-principles</a> (<a href="https://github.com/w3ctag/design-principles/issues/new">file an issue</a>; <a href="https://github.com/w3ctag/design-principles/issues?state=open">open issues</a>)
23+
Required IDs: using-http
2324
2425
Link Defaults: html (dfn) queue a task/in parallel/reflect
2526
</pre>
@@ -78,6 +79,8 @@ urlPrefix: https://w3c.github.io/geolocation-api/; spec: geolocation
7879
urlPrefix: https://html.spec.whatwg.org/multipage/; spec: HTML
7980
url: system-state.html#dom-navigator-online; type: attribute; for: NavigatorOnline; text: onLine;
8081
url: media.html#dom-media-play; type:method; for:HTMLMediaElement; text:play()
82+
urlPrefix: https://www.rfc-editor.org/rfc/rfc9110.html; spec: rfc9110
83+
url: #name-accept; type: http-header; text: Accept
8184
urlPrefix: https://w3c.github.io/remote-playback/; spec: REMOTE-PLAYBACK
8285
url: #remoteplayback-interface; type:interface; text: RemotePlayback
8386
url: #dfn-remote-playback-devices; type:dfn; text: remote playback device
@@ -561,9 +564,11 @@ An incomplete list of such guidance follows:
561564

562565
* [[encoding#specification-hooks|Encoding]]
563566
* [[fetch#fetch-elsewhere|Fetch]]
567+
* <span id="using-http">[[RFC9205 inline]]</span>,
568+
especially on [[RFC9205#section-4.7|defining header fields]], and
569+
[other HTTP RFCs](https://datatracker.ietf.org/doc/search?name=HTTP&amp;sort=&amp;rfcs=on&amp;by=group&amp;group=httpbis)
564570
* [[hr-time#sec-tools|Time]]
565571
* [[url#url-apis-elsewhere|URLs]]
566-
* [[#using-http]]
567572

568573
Consult with the relevant community
569574
when using their specification.
@@ -1107,7 +1112,7 @@ even if this means using another character to separate values.
11071112
<div class=example>
11081113

11091114
The <{input/accept}> attribute is a comma-separated list of values,
1110-
because it needs to match the syntax of the `Accept` HTTP header. (See [[#using-http|guidance on HTTP headers]])
1115+
because it needs to match the syntax of the [:Accept:] HTTP header.
11111116

11121117
</div>
11131118

@@ -3136,30 +3141,6 @@ due to security implications, and instead recommend enforcing strict MIME types
31363141

31373142
New MIME types should have a specification and should be registered with the Internet Assigned Numbers Authority (IANA).
31383143

3139-
<h3 id="using-http">Consult documentation on best practices when using HTTP</h3>
3140-
3141-
When using [[RFC9110|HTTP]],
3142-
consult [[RFC9205 inline]]
3143-
for advice on correct usage of the protocol.
3144-
3145-
[Fetch](https://fetch.spec.whatwg.org/) is the way that
3146-
user agents most often interact with servers.
3147-
Fetch defines the CORS protocol and necessary security checks.
3148-
Outside of those constraints necessary for security,
3149-
Fetch does not provide guidelines on how to best use HTTP.
3150-
Appropriate use of methods, header fields, content types, caching, and other HTTP features
3151-
might need to be defined.
3152-
3153-
Recommendations on best practices for HTTP
3154-
can be found in [[RFC9205 inline]] and
3155-
[other HTTP RFCs](https://datatracker.ietf.org/doc/search?name=HTTP&amp;sort=&amp;rfcs=on&amp;by=group&amp;group=httpbis).
3156-
RFC 9205 includes advice on
3157-
[[RFC9205#section-4.3|specifying client behavior]],
3158-
[[RFC9205#section-4.7|defining header fields]],
3159-
[[RFC9205#section-4.8|use of media types]],
3160-
[[RFC9205#section-4.16|evolving specifications]], and
3161-
other advice on how to get the most out of HTTP.
3162-
31633144
<h3 id="extend-manifests">Extend existing manifest files rather than creating new ones</h3>
31643145

31653146
If your feature requires a manifest,

0 commit comments

Comments
 (0)