diff --git a/README.md b/README.md
index 5519780b..3d54b8d1 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,7 @@
- [__UI__](./docs/UI.md)
- - [`useAudio`](./docs/useAudio.md) — plays audio and exposes controls.
+ - [`useAudio`](./docs/useAudio.md) — plays audio and exposes its controls.
- [__Animations__](./docs/Animations.md)
diff --git a/docs/useAudio.md b/docs/useAudio.md
index b654ae93..24fe7475 100644
--- a/docs/useAudio.md
+++ b/docs/useAudio.md
@@ -45,13 +45,13 @@ const [audio, state, controls, ref] = useAudio(props);
```
`audio` is React's `` element that you have to insert somewhere in your
-render tree, for example
+render tree, for example:
```jsx
{audio}
```
-`state` represents the state of the audio and the the following shape
+`state` tracks the state of the audio and has the following shape:
```json
{
@@ -70,7 +70,7 @@ render tree, for example
```
`controls` is a list collection of methods that allow you to control the
-playback of the audio, it has the following interface
+playback of the audio, it has the following interface:
```ts
interface AudioControls {
@@ -83,4 +83,7 @@ interface AudioControls {
}
```
+`ref` is a React reference to HTML `` element, you can access the element by
+`ref.current`, note that it may be `null`.
+
And finally, `props` — all props that `` accepts.