Skip to content
5 changes: 5 additions & 0 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -2203,6 +2203,8 @@ is a request, rather than a guarantee.
<h3 id="string-constants">Use strings for constants and enums</h3>

Use strings as the values for constants or sets of enumerated values.
See [[#naming-is-hard]] when choosing strings.
See [[#naming-is-hard]] when choosing strings.

Strings make it easier for developers to inspect values
and read code that uses those values.
Expand Down Expand Up @@ -3798,6 +3800,9 @@ API naming *must* be done in easily readable US English.
Keep in mind that most web developers aren't native English speakers.
Whenever possible, names should be chosen that use common vocabulary
a majority of English speakers are likely to understand when first encountering the name.
Avoid abbreviations,
except in cases where an abbreviation is extremely common and easy to understand.
For example `UIEvent`, where "`UI`" stands for user interface.

<div class="example">

Expand Down