@@ -310,10 +310,10 @@ Do not assume that a change or removal is impossible without first checking.
310
310
<h3 id=removing-features>Prioritize compatibility when changing or removing features</h3>
311
311
312
312
Before changing how a feature behaves,
313
- fully understand how websites are currently using it.
314
- This might require research,
313
+ understand how websites are currently using it.
314
+ Gaining a good understanding might require research,
315
315
for example by adding metrics to a popular user agent
316
- and/ or by [searching the HTTP Archive] (https://har.fyi/guides/getting-started/).
316
+ or by [searching the HTTP Archive] (https://har.fyi/guides/getting-started/).
317
317
Breaking content is harmful,
318
318
and the benefit of a change has to
319
319
significantly outweigh that harm to be worth doing.
@@ -337,7 +337,7 @@ Breakage is more likely to be acceptable if:
337
337
but is instead found on internal sites
338
338
with a controlled user environment.
339
339
Beware in this case that internal sites are
340
- often invisible to our analysis tools.
340
+ often invisible to analysis tools designed for public content .
341
341
Getting a single complaint is often a sign
342
342
of a much larger amount of hidden breakage.
343
343
* The benefit of breaking content is very large.
0 commit comments