Skip to content

Commit bfe35ee

Browse files
Apply changes from discussion
Co-authored-by: Martin Thomson <[email protected]>
1 parent 997d0c0 commit bfe35ee

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
@@ -307,10 +307,10 @@ Do not assume that a change or removal is impossible without first checking.
307307
<h3 id=removing-features>Prioritize compatibility when changing or removing features</h3>
308308

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

0 commit comments

Comments
 (0)