Skip to content

Commit c8f54ad

Browse files
authored
Lowercase web platform, inkeeping with WHATWG style guide, fixes #294 (#343)
1 parent 0bd75b3 commit c8f54ad

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

index.bs

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ED: https://w3ctag.github.io/design-principles/
99
Editor: Sangwhan Moon, Invited Expert, https://sangwhan.com
1010
Former Editor: Domenic Denicola, Google https://www.google.com/, https://domenic.me/, [email protected]
1111
Former Editor: Travis Leithead, Microsoft, [email protected]
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.
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.
1313
Default Biblio Status: current
1414
Markup Shorthands: markdown on
1515
Boilerplate: feedback-header off
@@ -236,7 +236,7 @@ at a very wide range of screen sizes,
236236
may be used to generate printed media,
237237
and may be interacted with in a large number of different ways.
238238
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.
240240

241241
<div class="note">
242242
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.
351351

352352
<!-- TODO: example? -->
353353

354-
Since the Web Platform has gradually evolved over time,
354+
Since the web platform has gradually evolved over time,
355355
there are often multiple conflicting precedents
356356
which are mutually exclusive.
357357
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).
364364
There is often a tension between internal and external consistency.
365365
<em>Internal consistency</em> is consistency with the rest of the system,
366366
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:
368368
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,
370370
and in some cases external precedent,
371371
when the API relates to a particular specialized outside domain.
372372
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:
14771477
If an API method needs to be asynchronous, use Promises,
14781478
not callback functions.
14791479

1480-
Using Promises consistently across the Web platform
1480+
Using Promises consistently across the web platform
14811481
means that APIs are easier to use together,
14821482
such as by chaining promises.
14831483
Promise-using code also tends to be easier to understand

0 commit comments

Comments
 (0)