From a52d34023cf48a2607c7fbb13f78eb6e301d861d Mon Sep 17 00:00:00 2001
From: Brian Ng <bng412@gmail.com>
Date: Fri, 19 May 2017 13:56:57 -0500
Subject: [PATCH] Add spec option example for transform-es2015-arrow-functions
 [skip ci] (#5698)

---
 .../README.md                                 | 47 ++++++++++++++++++-
 1 file changed, 46 insertions(+), 1 deletion(-)

diff --git a/packages/babel-plugin-transform-es2015-arrow-functions/README.md b/packages/babel-plugin-transform-es2015-arrow-functions/README.md
index 9a5ab5b2f5..61e3a3c7c9 100644
--- a/packages/babel-plugin-transform-es2015-arrow-functions/README.md
+++ b/packages/babel-plugin-transform-es2015-arrow-functions/README.md
@@ -101,4 +101,49 @@ require("babel-core").transform("code", {
 
 `boolean`, defaults to `false`.
 
-This option wraps the generated function in `.bind(this)` and keeps uses of `this` inside the function as-is, instead of using a renamed `this`. It also adds a runtime check to ensure the functions are not instantiated.
+<p><details>
+  <summary><b>Example</b></summary>
+
+  Using spec mode with the above example produces:
+
+  ```js
+  var _this = this;
+
+  var a = function a() {
+    babelHelpers.newArrowCheck(this, _this);
+  }.bind(this);
+  var a = function a(b) {
+    babelHelpers.newArrowCheck(this, _this);
+    return b;
+  }.bind(this);
+
+  const double = [1, 2, 3].map(function (num) {
+    babelHelpers.newArrowCheck(this, _this);
+    return num * 2;
+  }.bind(this));
+  console.log(double); // [2,4,6]
+
+  var bob = {
+    _name: "Bob",
+    _friends: ["Sally", "Tom"],
+    printFriends() {
+      var _this2 = this;
+
+      this._friends.forEach(function (f) {
+        babelHelpers.newArrowCheck(this, _this2);
+        return console.log(this._name + " knows " + f);
+      }.bind(this));
+    }
+  };
+  console.log(bob.printFriends());
+  ```
+</details></p>
+
+This option enables the following:
+
+ - Wrap the generated function in `.bind(this)` and keeps uses of `this` inside
+   the function as-is, instead of using a renamed `this`.
+
+ - Add a runtime check to ensure the functions are not instantiated.
+
+ - Add names to arrow functions.