@@ -2784,7 +2784,7 @@ As more specific information is shared,
2784
2784
the
2785
2785
[fingerprinting data] (https://www.w3.org/TR/fingerprinting-guidance/)
2786
2786
available to sites gets larger.
2787
- There are also [other potential risks] ( [[ PRIVACY-PRINCIPLES#threats]] )
2787
+ There are also [[ PRIVACY-PRINCIPLES#threats|other potential risks]]
2788
2788
to user privacy.
2789
2789
2790
2790
If there is no way to design a less powerful API,
@@ -3634,7 +3634,7 @@ Names take meaning from:
3634
3634
* use (how people come to understand the name over time)
3635
3635
* context (the object on the left-hand side, for example)
3636
3636
3637
- <h3 id="naming-common-words">Use common words</h4 >
3637
+ <h3 id="naming-common-words">Use common words</h3 >
3638
3638
3639
3639
API naming *must* be done in easily readable US English.
3640
3640
Keep in mind that most web developers aren't native English speakers.
@@ -3668,12 +3668,12 @@ to name this API less directly connected to its return type. [[FETCH]]
3668
3668
3669
3669
</div>
3670
3670
3671
- <h3 id="naming-charset">Use ASCII names</h4 >
3671
+ <h3 id="naming-charset">Use ASCII names</h3 >
3672
3672
3673
3673
Names must adhere to the local language restrictions, for example CSS ident rules etc.
3674
3674
and *should* be in the [=ascii code point|ASCII range=] .
3675
3675
3676
- <h3 id="naming-consultation">Consult others on naming</h4 >
3676
+ <h3 id="naming-consultation">Consult others on naming</h3 >
3677
3677
3678
3678
Consult widely on names in your APIs.
3679
3679
@@ -3728,7 +3728,7 @@ such as an author or user,
3728
3728
use the generic pronoun "they", "their", etc.
3729
3729
For example, "A user may wish to adjust their preferences".
3730
3730
3731
- <h3 id="naming-future-proofing">Use future-proof names</h4 >
3731
+ <h3 id="naming-future-proofing">Use future-proof names</h3 >
3732
3732
3733
3733
Naming should be generic and future-proof whenever possible.
3734
3734
@@ -3755,7 +3755,7 @@ as they were to PS/2 and ADB keyboards back then. [[UIEVENTS]]
3755
3755
3756
3756
</div>
3757
3757
3758
- <h3 id="naming-consistency">Name things consistently</h4 >
3758
+ <h3 id="naming-consistency">Name things consistently</h3 >
3759
3759
Naming schemes should aim for consistency, to avoid confusion.
3760
3760
3761
3761
Sets of related names should agree with each other in:
@@ -3764,14 +3764,14 @@ Sets of related names should agree with each other in:
3764
3764
or they should all describe what is denied
3765
3765
3766
3766
<h4 id="naming-booleans" class="no-num no-toc">Boolean properties vs.
3767
- boolean-returning methods</h5 >
3767
+ boolean-returning methods</h4 >
3768
3768
3769
3769
Boolean properties, options, or API arguments which are asking a question about
3770
3770
their argument *should not* be prefixed with <code> is</code> , while methods
3771
3771
that serve the same purpose, given that it has no side effects, *should* be
3772
3772
prefixed with <code> is</code> to be consistent with the rest of the platform.
3773
3773
3774
- <h4 id="casing-rules" class="no-num no-toc">Use casing rules consistent with existing APIs</h5 >
3774
+ <h4 id="casing-rules" class="no-num no-toc">Use casing rules consistent with existing APIs</h4 >
3775
3775
3776
3776
Although they haven't always been uniformly followed, through the history of web platform API
3777
3777
design, the following rules have emerged:
@@ -3824,8 +3824,8 @@ design, the following rules have emerged:
3824
3824
<tr>
3825
3825
<th> Events</th>
3826
3826
<td> Lowercase, concatenated</td>
3827
- <td><code> {{canplaythrough}} <br>
3828
- <code> {{languagechange}} </td>
3827
+ <td><code> {{canplaythrough}} </code>< br>
3828
+ <code> {{languagechange}} </code></ td>
3829
3829
</tr>
3830
3830
<tr>
3831
3831
<th> HTML elements and attributes</th>
@@ -3886,7 +3886,7 @@ existing factory methods
3886
3886
under the same object, such as `document.initXXX()`.
3887
3887
New factory methods should not follow this convention.
3888
3888
3889
- <h3 id="naming-unsafe">Warn about dangerous features</h4 >
3889
+ <h3 id="naming-unsafe">Warn about dangerous features</h3 >
3890
3890
3891
3891
Where possible, mark features that weaken
3892
3892
the guarantees provided to developers
0 commit comments