From 09526582ceac45db3530e24ca58765cd57e52e20 Mon Sep 17 00:00:00 2001
From: streamich <streamich@gmail.com>
Date: Sun, 28 Oct 2018 10:29:26 +0100
Subject: [PATCH] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20improve=20useAudio?=
 =?UTF-8?q?=20docs?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md        | 2 +-
 docs/useAudio.md | 9 ++++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 5519780b..3d54b8d1 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,7 @@
      <br/>
      <br/>
 - [__UI__](./docs/UI.md)
-   - [`useAudio`](./docs/useAudio.md) &mdash; plays audio and exposes controls.
+   - [`useAudio`](./docs/useAudio.md) &mdash; plays audio and exposes its controls.
      <br/>
      <br/>
 - [__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 `<audio>` element that you have to insert somewhere in your
-render tree, for example
+render tree, for example:
 
 ```jsx
 <div>{audio}</div>
 ```
 
-`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 `<audio>` element, you can access the element by
+`ref.current`, note that it may be `null`.
+
 And finally, `props` &mdash; all props that `<audio>` accepts.