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