Skip to content

Commit e10b073

Browse files
lolaodelolamartinthomsonjyasskinmarcoscaceres
authored
Add Text: Mitigate defects when extending features. (#563)
* Draft text for issue #514 * Fix: Break lines at 100ch * use semantic line breaks * Remove redundancies * Reframe fixing existing defects to include our reasoning * rewrap Co-authored-by: Jeffrey Yasskin <[email protected]> * Fine tune wording on consistency Co-authored-by: Marcos Cáceres <[email protected]> --------- Co-authored-by: Martin Thomson <[email protected]> Co-authored-by: Jeffrey Yasskin <[email protected]> Co-authored-by: Marcos Cáceres <[email protected]>
1 parent 2dacfea commit e10b073

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

index.bs

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -324,15 +324,25 @@ they are also defined by how content uses those features.
324324
<h3 id="leave-the-web-better">Leave the web better than you found it</h3>
325325

326326
As you add new capabilities to the web platform,
327-
do so in a way that improves the overall platform,
328-
for example its security, privacy or accessibility characteristics.
327+
do so in a way that improves the overall platform.
329328

330329
The existence of a defect in one part of the platform
331330
must not be used to excuse an addition or extension to the defect,
332331
which would further decrease the overall platform quality.
332+
333+
Consistency with existing problematic design patterns
334+
is not a good reason to propagate those patterns
335+
in newly specified Web APIs or platform features.
333336
Where possible, build new web capabilities that improve the overall platform quality
334337
by mitigating existing defects.
335-
Do not degrade existing capabilities without good reason.
338+
339+
Do not extend a platform feature that has known defects,
340+
without considering how to address those defects.
341+
It is not necessary to completely fix existing problems,
342+
but some attempt to address flaws is expected
343+
when extending a feature with known issues.
344+
This way, new or increased usage does not result in
345+
increasing the harm that the defect might cause.
336346

337347
Parts of the web platform evolve independently.
338348
Issues that are present with a certain web technology now may be fixed in a subsequent iteration.

0 commit comments

Comments
 (0)