Skip to content

Commit be6338e

Browse files
committed
[css-2015] Swap order of sections
1 parent 751132a commit be6338e

1 file changed

Lines changed: 36 additions & 34 deletions

File tree

css-2015/Overview.bs

Lines changed: 36 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -419,6 +419,41 @@ Requirements for Responsible Implementation of CSS</h2>
419419
Note: Vendors should consult the WG explicitly and not make assumptions on this point,
420420
as a pre-CR spec that hasn't changed in awhile is usually more out-of-date than stable.
421421

422+
423+
<h4 id="proprietary">
424+
Proprietary and Non-standardized Features</h4>
425+
426+
Issue: Rewritten as open vs. closed systems instead of Web vs. non-Web, per szilles' request.
427+
428+
A CSS feature is a <dfn>proprietary extension</dfn> if it is meant for use
429+
in a closed environment accessible only to a single vendor's user agent(s).
430+
A UA should support such <a>proprietary extensions</a>
431+
only through a vendor-prefixed syntax
432+
and not expose them to open (multi-UA) environments such as the World Wide Web.
433+
434+
<details class=why>
435+
<summary>Why?</summary>
436+
The prefixing requirement allows shipping specialized features in closed environments
437+
without conflicting with future additions to standard CSS.
438+
The restriction on exposure to open systems is to prevent
439+
accidentally causing the public CSS environment
440+
to depend on an unstandardized <a>proprietary extensions</a>.
441+
</details>
442+
443+
<div class="example">
444+
For example,
445+
Firefox's XUL-based UI, Apple's iTunes UI, and Microsoft's Universal Windows Platform app
446+
use extensions to CSS implemented by their respective UAs.
447+
So long as these UAs do not allow Web content to access these features,
448+
they do not provide an opportunity for such content
449+
to become dependent on their <a>proprietary extensions</a>.
450+
</div>
451+
452+
Even if a feature is intended to eventually be used in the Web,
453+
if it hasn't yet been standardized
454+
it should still not be exposed to the Web.
455+
456+
422457
<h4 id="de-facto">
423458
Market Pressure and De Facto Standards</h4>
424459

@@ -427,7 +462,7 @@ Requirements for Responsible Implementation of CSS</h2>
427462
If a feature is <a>unstable</a>, yet
428463

429464
* at least three UAs implement the feature
430-
(or a browser has broken the other rules and shipped for broad use
465+
(or a UA has broken the other rules and shipped for broad use
431466
an <a>unstable</a> or otherwise non-standard feature in a production release),
432467
* <em>and</em> the implementations have rough interoperability,
433468
* <em>and</em> the CSS Working Group has recorded consensus
@@ -476,39 +511,6 @@ Requirements for Responsible Implementation of CSS</h2>
476511
<ins>and avoid other obstacles (e.g., platform dependency, licensing restrictions)
477512
to their competitors shipping the feature.</ins>
478513

479-
<h4 id="proprietary">
480-
Proprietary and Non-standardized Features</h4>
481-
482-
Issue: Rewritten as open vs. closed systems instead of Web vs. non-Web, per szilles' request.
483-
484-
A CSS feature is a <dfn>proprietary extension</dfn> if it is meant for use
485-
in a closed environment accessible only to a single vendor's user agent(s).
486-
A UA should support such <a>proprietary extensions</a>
487-
only through a vendor-prefixed syntax
488-
and not expose them to open (multi-UA) environments such as the World Wide Web.
489-
490-
<details class=why>
491-
<summary>Why?</summary>
492-
The prefixing requirement allows shipping specialized features in closed environments
493-
without conflicting with future additions to standard CSS.
494-
The restriction on exposure to open systems is to prevent
495-
accidentally causing the public CSS environment
496-
to depend on an unstandardized <a>proprietary extensions</a>.
497-
</details>
498-
499-
<div class="example">
500-
For example,
501-
Firefox's XUL-based UI, Apple's iTunes UI, and Microsoft's Universal Windows Platform app
502-
use extensions to CSS implemented by their respective UAs.
503-
So long as these UAs do not allow Web content to access these features,
504-
they do not provide an opportunity for such content
505-
to become dependent on their <a>proprietary extensions</a>.
506-
</div>
507-
508-
Even if a feature is intended to eventually be used in the Web,
509-
if it hasn't yet been standardized
510-
it should still not be exposed to the Web.
511-
512514

513515
<h3 id="testing">Implementations of CR-level Features</h3>
514516

0 commit comments

Comments
 (0)