Skip to content

Commit f2f2641

Browse files
Add a section about looking for guidance in other specs. (#542)
* Add a section about looking for guidance in other specs. * Take Martin's rewording. Co-authored-by: Martin Thomson <[email protected]> * Add #using-http as guidance from a feature specification. Co-authored-by: Martin Thomson <[email protected]> * Add guidance to talk to the relevant community. --------- Co-authored-by: Martin Thomson <[email protected]>
1 parent c63b666 commit f2f2641

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

index.bs

+26
Original file line numberDiff line numberDiff line change
@@ -545,6 +545,32 @@ i.e. consistency within CSS.
545545

546546
There is also a separate section on <a href="#naming-consistency">naming consistency</a>.
547547

548+
<h3 id="specs-include-guidance">Follow guidance from feature specifications</h3>
549+
550+
When using a feature,
551+
follow guidance in the specification for that feature.
552+
553+
Specifications for features
554+
that will be used by other specifications
555+
should include guidance for using those features.
556+
This ensures that the feature is used correctly
557+
and consistently
558+
throughout the platform.
559+
560+
An incomplete list of such guidance follows:
561+
562+
* [[encoding#specification-hooks|Encoding]]
563+
* [[fetch#fetch-elsewhere|Fetch]]
564+
* [[hr-time#sec-tools|Time]]
565+
* [[url#url-apis-elsewhere|URLs]]
566+
* [[#using-http]]
567+
568+
Consult with the relevant community
569+
when using their specification.
570+
This informs that community about new usage
571+
and creates opportunities for improvements
572+
to both the using and used specifications.
573+
548574
<h3 id="feature-detect">New features should be detectable</h3>
549575

550576
Provide a way for authors to programmatically detect

0 commit comments

Comments
 (0)