From 6231dceb1cc99c8afb17a5eacc15d3331a570bcf Mon Sep 17 00:00:00 2001
From: Sebastian McKenzie <sebmck@gmail.com>
Date: Sun, 23 Nov 2014 15:29:21 +1100
Subject: [PATCH] clarify polyfill usage

---
 doc/polyfill.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/doc/polyfill.md b/doc/polyfill.md
index 619602e0e7..631f9adb73 100644
--- a/doc/polyfill.md
+++ b/doc/polyfill.md
@@ -12,6 +12,9 @@ when using [6to5-node](usage.md#node).
 
 ### Node
 
+You need to include the polyfill require at the top the **entry point** to your
+application.
+
 ```javascript
 require("6to5/polyfill");
 ```
@@ -19,4 +22,6 @@ require("6to5/polyfill");
 ### Browser
 
 Available from the `browser-polyfill.js` file within the 6to5 directory of an
-npm release.
+npm release. This needs to be included **before** all your compiled 6to5 code.
+You can either prepend it to your compiled code or include it in a `<script>`
+before it.