Skip to content

Commit a6958f5

Browse files
committed
[css-2015] Clarify why unstable features should be released both prefixed and unprefixed
1 parent cc82bd4 commit a6958f5

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

css-2015/Overview.bs

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -504,12 +504,40 @@ Requirements for Responsible Implementation of CSS</h2>
504504
Once the feature has stabilized and the implementation is updated to match interoperable behavior,
505505
support for the prefixed syntax should be removed.
506506

507+
Note: Anyone promoting <a>unstable</a> features to authors
508+
is urged to describe them
509+
through their standard unprefixed syntax,
510+
and to avoid encouraging the use of the prefixed syntax
511+
for any purpose other than working around implementation differences.
512+
507513
<details class=why>
508514
<summary>Why?</summary>
509515
This is recommended so that authors can use the unprefixed syntax to target all implementations,
510516
but when necessary, can target specific implementations
511517
to work around incompatibilities among implementations
512518
as they get ironed out through the standards/bugfixing process.
519+
520+
Some authors unfamiliar with this approach
521+
and accustomed to the earlier practice
522+
of shipping unstable features only under a prefix
523+
may fail to notice that using the unprefixed syntax
524+
is sufficient to target all implementations,
525+
and may therethore include the prefixed syntax
526+
of the various vendors
527+
followed by the unprefixed syntax.
528+
529+
Even in the face of this possible misuse,
530+
this approach still beneficial.
531+
The lack of a phase
532+
where only the prefixed syntax is supported
533+
greatly reduces the risk of stylesheets
534+
targetting only this prefixed syntax being written.
535+
This in turns allow UA vendors to retire
536+
their prefixed syntax once the feature is stable,
537+
without risking breaking existing content.
538+
It also reduces the need occasionally felt by by some vendors
539+
to support a feature with the prefix of another vendor,
540+
due to content depending on that syntax.
513541
</details>
514542

515543
In order to preserve the open nature of CSS as a technology,

0 commit comments

Comments
 (0)