You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Abstract: This document contains a set of design principles to be used when designing Web Platform technologies. These principles have been collected during the Technical Architecture Group's discussions in <a href="https://github.com/w3ctag/design-reviews/">reviewing</a> developing specifications, and build upon the Ethical Web Principles [[ETHICAL-WEB]]. We encourage specification designers to read this document and use it as a resource when making design decisions.
12
+
Abstract: This document contains a set of design principles to be used when designing web platform technologies. These principles have been collected during the Technical Architecture Group's discussions in <a href="https://github.com/w3ctag/design-reviews/">reviewing</a> developing specifications, and build upon the Ethical Web Principles [[ETHICAL-WEB]]. We encourage specification designers to read this document and use it as a resource when making design decisions.
13
13
Default Biblio Status: current
14
14
Markup Shorthands: markdown on
15
15
Boilerplate: feedback-header off
@@ -236,7 +236,7 @@ at a very wide range of screen sizes,
236
236
may be used to generate printed media,
237
237
and may be interacted with in a large number of different ways.
238
238
New features should match the [existing flexibility](https://www.w3.org/2001/tag/doc/ethical-web-principles/#render)
239
-
of the Web platform.
239
+
of the web platform.
240
240
241
241
<div class="note">
242
242
This doesn't imply that features which don't work in *every* possible context should be excluded.
@@ -351,7 +351,7 @@ but the improvement should be very significant to justify this.
351
351
352
352
<!-- TODO: example? -->
353
353
354
-
Since the Web Platform has gradually evolved over time,
354
+
Since the web platform has gradually evolved over time,
355
355
there are often multiple conflicting precedents
356
356
which are mutually exclusive.
357
357
You can weigh which precdent to follow by taking into account
@@ -364,9 +364,9 @@ and API age (all else being equal, follow the newer precedent).
364
364
There is often a tension between internal and external consistency.
365
365
<em>Internal consistency</em> is consistency with the rest of the system,
366
366
whereas <em>external consistency</em> is consistency with the rest of the world.
367
-
In the Web Platform, that might materialize in three layers:
367
+
In the web platform, that might materialize in three layers:
368
368
consistency within the technology the API belongs to (e.g. CSS),
369
-
consistency with the rest of the Web Platform,
369
+
consistency with the rest of the web platform,
370
370
and in some cases external precedent,
371
371
when the API relates to a particular specialized outside domain.
372
372
In those cases, it is useful to consider what the majority of users will be.
@@ -1477,7 +1477,7 @@ An API should generally be synchronous if the following rules of thumb apply:
1477
1477
If an API method needs to be asynchronous, use Promises,
1478
1478
not callback functions.
1479
1479
1480
-
Using Promises consistently across the Web platform
1480
+
Using Promises consistently across the web platform
1481
1481
means that APIs are easier to use together,
1482
1482
such as by chaining promises.
1483
1483
Promise-using code also tends to be easier to understand
0 commit comments