diff --git a/docs/ecosystem-user-event.mdx b/docs/ecosystem-user-event.mdx
index e2fcda016..7d449a79d 100644
--- a/docs/ecosystem-user-event.mdx
+++ b/docs/ecosystem-user-event.mdx
@@ -30,8 +30,9 @@ test('types inside textarea', () => {
## API
Note: All userEvent methods are synchronous with one exception: when `delay`
-option used with `userEvent.type` as described below. We also discourage using `userEvent`
-inside `before/after` blocks at all, for important reasons described in
+option used with `userEvent.type` as described below. We also discourage using
+`userEvent` inside `before/after` blocks at all, for important reasons described
+in
["Avoid Nesting When You're Testing"](https://kentcdodds.com/blog/avoid-nesting-when-youre-testing).
### `click(element, eventInit, options)`
@@ -206,8 +207,8 @@ test('types into the input', () => {
### `upload(element, file, [{ clickInit, changeInit }])`
Uploads file to an ``. For uploading multiple files use `` with
-`multiple` attribute and the second `upload` argument must be array then. Also
-it's possible to initialize click or change event with using third argument.
+the `multiple` attribute and the second `upload` argument as an array. It's also
+possible to initialize a click or change event using a third argument.
```jsx
import React from 'react'