Skip to content

Commit ec1d5a8

Browse files
Apply changes from discussion
Co-authored-by: Martin Thomson <[email protected]>
1 parent 72c6e6d commit ec1d5a8

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

index.bs

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -310,10 +310,10 @@ Do not assume that a change or removal is impossible without first checking.
310310
<h3 id=removing-features>Prioritize compatibility when changing or removing features</h3>
311311

312312
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,
315315
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/).
317317
Breaking content is harmful,
318318
and the benefit of a change has to
319319
significantly outweigh that harm to be worth doing.
@@ -337,7 +337,7 @@ Breakage is more likely to be acceptable if:
337337
but is instead found on internal sites
338338
with a controlled user environment.
339339
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.
341341
Getting a single complaint is often a sign
342342
of a much larger amount of hidden breakage.
343343
* The benefit of breaking content is very large.

0 commit comments

Comments
 (0)