From 15f73b4fc393fef9763051f242d9466b633fbc83 Mon Sep 17 00:00:00 2001
From: Sebastian McKenzie <sebmck@gmail.com>
Date: Tue, 1 Sep 2015 04:56:03 +0100
Subject: [PATCH] remove noisy comments/documentation

---
 packages/babel-cli/README.md                  |   4 -
 packages/babel-code-frame/README.md           |   1 +
 packages/babel-core/README.md                 |   1 +
 packages/babel-core/src/README.md             |   4 -
 packages/babel-core/src/api/README.md         |  18 --
 packages/babel-core/src/helpers/README.md     |   4 -
 packages/babel-core/src/tools/README.md       |  15 --
 .../src/tools/build-external-helpers.js       |  22 +--
 .../babel-core/src/transformation/README.md   |   3 -
 .../src/transformation/file/README.md         |   3 -
 .../src/transformation/file/logger.js         |  32 ----
 .../src/transformation/file/options/README.md |   3 -
 .../file/options/option-manager.js            |  24 ---
 .../transformation/file/options/parsers.js    |   4 -
 .../src/transformation/file/plugin-manager.js |  37 ----
 .../src/transformation/helpers/README.md      |   3 -
 ...-binary-assignment-operator-transformer.js |  24 ---
 .../helpers/build-comprehension.js            |   4 -
 ...itional-assignment-operator-transformer.js |  17 --
 .../helpers/build-react-transformer.js        |  32 ----
 .../transformation/helpers/call-delegate.js   |  17 --
 .../src/transformation/helpers/define-map.js  |  20 --
 .../helpers/explode-assignable-expression.js  |  12 --
 .../helpers/get-function-arity.js             |   4 -
 .../helpers/memoise-decorators.js             |   4 -
 .../src/transformation/helpers/name-method.js |  37 ----
 .../src/transformation/helpers/regex.js       |   8 -
 .../helpers/remap-async-to-generator.js       |  26 ---
 .../transformation/helpers/replace-supers.js  |  53 ------
 .../babel-core/src/transformation/index.js    |  24 ---
 .../src/transformation/modules/README.md      |   3 -
 .../src/transformation/modules/_default.js    |  88 ---------
 .../src/transformation/modules/_strict.js     |   4 -
 .../src/transformation/modules/amd-strict.js  |   4 -
 .../src/transformation/modules/amd.js         |  33 ----
 .../transformation/modules/common-strict.js   |   4 -
 .../src/transformation/modules/common.js      |  37 ----
 .../src/transformation/modules/ignore.js      |  13 --
 .../transformation/modules/lib/metadata.js    |  16 --
 .../src/transformation/modules/lib/remaps.js  |  49 -----
 .../src/transformation/modules/system.js      |  79 --------
 .../src/transformation/modules/umd-strict.js  |   4 -
 .../src/transformation/modules/umd.js         |   9 -
 .../babel-core/src/transformation/pipeline.js |  44 -----
 .../src/transformation/plugin-pass.js         |  12 --
 .../babel-core/src/transformation/plugin.js   |  16 --
 .../src/transformation/transformers/README.md |   3 -
 .../es3/member-expression-literals.js         |   1 -
 .../transformers/es3/property-literals.js     |   3 +-
 .../transformers/es5/properties.mutators.js   |   1 -
 .../transformers/es6/arrow-functions.js       |   1 -
 .../transformers/es6/block-scoping/index.js   | 128 +------------
 .../transformers/es6/block-scoping/tdz.js     |  21 ---
 .../transformers/es6/classes/index.js         |  12 --
 .../transformers/es6/classes/loose.js         |   8 -
 .../transformers/es6/classes/vanilla.js       | 104 +----------
 .../transformers/es6/constants.js             |   1 -
 .../transformers/es6/destructuring.js         |  86 ---------
 .../transformation/transformers/es6/for-of.js |  21 ---
 .../transformers/es6/modules.js               |  21 ---
 .../transformers/es6/object-super.js          |  13 --
 .../transformers/es6/parameters/default.js    |  22 ---
 .../transformers/es6/parameters/index.js      |   4 -
 .../transformers/es6/parameters/rest.js       |  40 +---
 .../transformers/es6/properties.computed.js   |  17 --
 .../transformers/es6/properties.shorthand.js  |   5 -
 .../transformers/es6/regex.sticky.js          |   9 -
 .../transformers/es6/regex.unicode.js         |   9 -
 .../transformers/es6/spec.symbols.js          |  17 --
 .../es6/spec.template-literals.js             |   9 -
 .../transformation/transformers/es6/spread.js |  29 ---
 .../transformers/es6/tail-call.js             |  98 ----------
 .../transformers/es6/template-literals.js     |  33 +---
 .../transformers/es7/comprehensions.js        |  17 --
 .../transformers/es7/decorators.js            |   9 -
 .../transformers/es7/do-expressions.js        |   9 -
 .../es7/exponentiation-operator.js            |   8 -
 .../transformers/es7/export-extensions.js     |  13 --
 .../transformers/es7/function-bind.js         |  25 ---
 .../transformers/es7/object-rest-spread.js    |  13 --
 .../transformation/transformers/filters.js    |  20 --
 .../src/transformation/transformers/index.js  |   1 -
 .../transformers/internal/block-hoist.js      |   5 -
 .../transformers/internal/hoist-directives.js |   9 -
 .../transformers/internal/module-formatter.js |   9 -
 .../transformers/internal/modules.js          |  25 ---
 .../transformers/internal/shadow-functions.js |  17 --
 .../transformers/internal/validation.js       |  13 --
 .../transformers/optimisation/flow.for-of.js  |   9 -
 .../optimisation/react.inline-elements.js     |  17 --
 .../transformers/other/async-to-generator.js  |   9 -
 .../transformers/other/bluebird-coroutines.js |  13 --
 .../transformation/transformers/other/flow.js |  29 ---
 .../transformers/other/react-compat.js        |  17 --
 .../transformers/other/react.js               |  21 ---
 .../transformers/other/regenerator.js         |   9 -
 .../transformers/other/strict.js              |  13 --
 .../spec/block-scoped-functions.js            |  17 --
 .../transformers/spec/function-name.js        |  13 --
 .../transformers/validation/react.js          |  13 --
 packages/babel-core/src/util.js               |   1 -
 packages/babel-generator/README.md            |   1 +
 packages/babel-generator/src/README.md        |  16 --
 packages/babel-generator/src/buffer.js        |   2 +-
 .../babel-generator/src/generators/README.md  |  10 -
 .../babel-generator/src/generators/base.js    |  23 +--
 .../babel-generator/src/generators/classes.js |  21 ---
 .../src/generators/comprehensions.js          |   8 -
 .../src/generators/expressions.js             |  94 +---------
 .../babel-generator/src/generators/flow.js    | 141 --------------
 .../babel-generator/src/generators/jsx.js     |  50 +----
 .../babel-generator/src/generators/methods.js |  21 ---
 .../babel-generator/src/generators/modules.js |  44 -----
 .../src/generators/statements.js              |  74 +-------
 .../src/generators/template-literals.js       |  12 --
 .../babel-generator/src/generators/types.js   |  33 ----
 packages/babel-generator/src/index.js         |  64 -------
 .../babel-generator/src/node/parentheses.js   |  58 ------
 .../babel-generator/src/node/whitespace.js    |   4 -
 packages/babel-generator/src/whitespace.js    |   7 +-
 packages/babel-runtime/README.md              |   4 -
 packages/babel-traverse/README.md             |   1 +
 packages/babel-traverse/src/README.md         |   3 -
 packages/babel-traverse/src/context.js        |  24 ---
 packages/babel-traverse/src/hub.js            |   3 +-
 packages/babel-traverse/src/index.js          |  32 ----
 packages/babel-traverse/src/path/README.md    |  15 --
 packages/babel-traverse/src/path/ancestry.js  |   6 +-
 packages/babel-traverse/src/path/comments.js  |   6 +-
 packages/babel-traverse/src/path/context.js   |  72 +-------
 .../babel-traverse/src/path/conversion.js     |  10 +-
 .../babel-traverse/src/path/evaluation.js     |   2 +
 packages/babel-traverse/src/path/family.js    |  34 +---
 packages/babel-traverse/src/path/index.js     |  52 ++----
 .../src/path/inference/README.md              |   3 -
 .../src/path/inference/index.js               |  22 +--
 .../src/path/inference/inferer-reference.js   |  24 ---
 .../src/path/inference/inferers.js            |  76 --------
 .../babel-traverse/src/path/introspection.js  |  10 +-
 .../babel-traverse/src/path/lib/hoister.js    |  36 ----
 .../src/path/lib/removal-hooks.js             |  20 --
 .../src/path/lib/virtual-types.js             |  52 ------
 .../babel-traverse/src/path/modification.js   |  30 +--
 packages/babel-traverse/src/path/removal.js   |  17 +-
 .../babel-traverse/src/path/replacement.js    |  18 +-
 packages/babel-traverse/src/scope/README.md   |   3 -
 packages/babel-traverse/src/scope/binding.js  |  16 +-
 packages/babel-traverse/src/scope/index.js    | 172 ------------------
 packages/babel-types/README.md                |   1 +
 packages/babel-types/src/converters.js        |  30 +--
 150 files changed, 66 insertions(+), 3376 deletions(-)
 create mode 100644 packages/babel-code-frame/README.md
 create mode 100644 packages/babel-core/README.md
 delete mode 100644 packages/babel-core/src/README.md
 delete mode 100644 packages/babel-core/src/api/README.md
 delete mode 100644 packages/babel-core/src/helpers/README.md
 delete mode 100644 packages/babel-core/src/tools/README.md
 delete mode 100644 packages/babel-core/src/transformation/README.md
 delete mode 100644 packages/babel-core/src/transformation/file/README.md
 delete mode 100644 packages/babel-core/src/transformation/file/options/README.md
 delete mode 100644 packages/babel-core/src/transformation/helpers/README.md
 delete mode 100644 packages/babel-core/src/transformation/modules/README.md
 delete mode 100644 packages/babel-core/src/transformation/transformers/README.md
 create mode 100644 packages/babel-generator/README.md
 delete mode 100644 packages/babel-generator/src/README.md
 delete mode 100644 packages/babel-generator/src/generators/README.md
 create mode 100644 packages/babel-traverse/README.md
 delete mode 100644 packages/babel-traverse/src/README.md
 delete mode 100644 packages/babel-traverse/src/path/README.md
 delete mode 100644 packages/babel-traverse/src/path/inference/README.md
 delete mode 100644 packages/babel-traverse/src/scope/README.md
 create mode 100644 packages/babel-types/README.md

diff --git a/packages/babel-cli/README.md b/packages/babel-cli/README.md
index 7af3d66051..0d36b69f45 100644
--- a/packages/babel-cli/README.md
+++ b/packages/babel-cli/README.md
@@ -1,5 +1 @@
 # babel-cli
-
-Babel CLI
-
-For more information please look at [babel](https://github.com/babel/babel).
diff --git a/packages/babel-code-frame/README.md b/packages/babel-code-frame/README.md
new file mode 100644
index 0000000000..35f7c2ebf7
--- /dev/null
+++ b/packages/babel-code-frame/README.md
@@ -0,0 +1 @@
+# babel-code-frame
diff --git a/packages/babel-core/README.md b/packages/babel-core/README.md
new file mode 100644
index 0000000000..beb313b67f
--- /dev/null
+++ b/packages/babel-core/README.md
@@ -0,0 +1 @@
+# babel-core
diff --git a/packages/babel-core/src/README.md b/packages/babel-core/src/README.md
deleted file mode 100644
index 6831fbaa9b..0000000000
--- a/packages/babel-core/src/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-## Diving into Babel
-
-If you look around in the various directories in here you'll find some details
-about the organization of the Babel codebase.
diff --git a/packages/babel-core/src/api/README.md b/packages/babel-core/src/api/README.md
deleted file mode 100644
index f1816a11f0..0000000000
--- a/packages/babel-core/src/api/README.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## API
-
-In this directory you'll find all the public interfaces to using Babel for both
-node and the browser.
-
-### Node
-
-There are two ways people use Babel within Node, they either are manipulating
-strings of code with `babel.transform` or `babel.parse`, they also might be
-running their code through Babel before execution via `register` or `polyfill`.
-
-### Browser
-
-Usage of Babel in the browser is extremely uncommon and in most cases
-considered A Bad Idea™. However it works by loading `<script>`'s with XHR,
-transforming them and then executing them. These `<script>`'s need to have a
-`type` of "text/ecmascript-6", "text/babel", or "module" ("text/6to5" exists as
-well for legacy reasons).
diff --git a/packages/babel-core/src/helpers/README.md b/packages/babel-core/src/helpers/README.md
deleted file mode 100644
index 6a5bf8df2d..0000000000
--- a/packages/babel-core/src/helpers/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-## Helpers
-
-Utilities for Babel, which is just another way to say "helpers", but I wrote it
-anyways, so– deal with it.
diff --git a/packages/babel-core/src/tools/README.md b/packages/babel-core/src/tools/README.md
deleted file mode 100644
index 8717420a33..0000000000
--- a/packages/babel-core/src/tools/README.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## Tools
-
-> This directory is best browsed while listening to
-> https://www.youtube.com/watch?v=hglVqACd1C8.
-
-### Protect Babel
-
-The protect script seen here is to throw errors if someone ever tries to
-include internal babel files in their script. If you need something to be
-exposed, you should ask for it, not try to hack your way into getting it.
-
-### External Helpers
-
-You'll also find the script for building the external helpers file, this is
-the Babel "runtime" where all helper functions go instead of the top of a file.
diff --git a/packages/babel-core/src/tools/build-external-helpers.js b/packages/babel-core/src/tools/build-external-helpers.js
index 0112341d6c..474da46340 100644
--- a/packages/babel-core/src/tools/build-external-helpers.js
+++ b/packages/babel-core/src/tools/build-external-helpers.js
@@ -5,10 +5,6 @@ import File from "../transformation/file";
 import each from "lodash/collection/each";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function buildGlobal(namespace, builder) {
   var body      = [];
   var container = t.functionExpression(null, [t.identifier("global")], t.blockStatement(body));
@@ -26,10 +22,6 @@ function buildGlobal(namespace, builder) {
   return tree;
 }
 
-/**
- * [Please add a description.]
- */
-
 function buildUmd(namespace, builder) {
   var body = [];
   body.push(t.variableDeclaration("var", [
@@ -42,17 +34,13 @@ function buildUmd(namespace, builder) {
     FACTORY_PARAMETERS: t.identifier("global"),
     BROWSER_ARGUMENTS:  t.assignmentExpression("=", t.memberExpression(t.identifier("root"), namespace), t.objectExpression({})),
     COMMON_ARGUMENTS:   t.identifier("exports"),
-    AMD_ARGUMENTS:      t.arrayExpression([t.literal("exports")]),
+    AMD_ARGUMENTS:      t.arrayExpression([t.stringLiteral("exports")]),
     FACTORY_BODY:       body,
     UMD_ROOT:           t.identifier("this")
   });
   return t.program([container]);
 }
 
-/**
- * [Please add a description.]
- */
-
 function buildVar(namespace, builder) {
   var body = [];
   body.push(t.variableDeclaration("var", [
@@ -62,10 +50,6 @@ function buildVar(namespace, builder) {
   return t.program(body);
 }
 
-/**
- * [Please add a description.]
- */
-
 function buildHelpers(body, namespace, whitelist) {
   each(File.helpers, function (name) {
     if (whitelist && whitelist.indexOf(name) === -1) return;
@@ -77,10 +61,6 @@ function buildHelpers(body, namespace, whitelist) {
   });
 }
 
-/**
- * [Please add a description.]
- */
-
 export default function (whitelist, outputType = "global") {
   var namespace = t.identifier("babelHelpers");
 
diff --git a/packages/babel-core/src/transformation/README.md b/packages/babel-core/src/transformation/README.md
deleted file mode 100644
index 637cff8d1c..0000000000
--- a/packages/babel-core/src/transformation/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Transformation
-
-This is the Transformation directory.
diff --git a/packages/babel-core/src/transformation/file/README.md b/packages/babel-core/src/transformation/file/README.md
deleted file mode 100644
index d42ce5497e..0000000000
--- a/packages/babel-core/src/transformation/file/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## File Transformation
-
-This is the File Transformation directory.
diff --git a/packages/babel-core/src/transformation/file/logger.js b/packages/babel-core/src/transformation/file/logger.js
index c12fc8efbe..35db09efc5 100644
--- a/packages/babel-core/src/transformation/file/logger.js
+++ b/packages/babel-core/src/transformation/file/logger.js
@@ -6,46 +6,26 @@ var generalDebug = buildDebug("babel");
 
 var seenDeprecatedMessages = [];
 
-/**
- * [Please add a description.]
- */
-
 export default class Logger {
   constructor(file: File, filename: string) {
     this.filename = filename;
     this.file     = file;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _buildMessage(msg: string): string {
     var parts = `[BABEL] ${this.filename}`;
     if (msg) parts += `: ${msg}`;
     return parts;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   warn(msg) {
     console.warn(this._buildMessage(msg));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   error(msg: string, Constructor = Error) {
     throw new Constructor(this._buildMessage(msg));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   deprecate(msg) {
     if (this.file.opts && this.file.opts.suppressDeprecationMessages) return;
 
@@ -60,26 +40,14 @@ export default class Logger {
     console.error(msg);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   verbose(msg: string) {
     if (verboseDebug.enabled) verboseDebug(this._buildMessage(msg));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   debug(msg: string) {
     if (generalDebug.enabled) generalDebug(this._buildMessage(msg));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   deopt(node: Object, msg: string) {
     this.debug(msg);
   }
diff --git a/packages/babel-core/src/transformation/file/options/README.md b/packages/babel-core/src/transformation/file/options/README.md
deleted file mode 100644
index 46cdbb6270..0000000000
--- a/packages/babel-core/src/transformation/file/options/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## File Options
-
-This is the File Options directory.
diff --git a/packages/babel-core/src/transformation/file/options/option-manager.js b/packages/babel-core/src/transformation/file/options/option-manager.js
index 5933c56d29..f1032a0e8d 100644
--- a/packages/babel-core/src/transformation/file/options/option-manager.js
+++ b/packages/babel-core/src/transformation/file/options/option-manager.js
@@ -32,10 +32,6 @@ export default class OptionManager {
     this.log             = log;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   static createBareOptions() {
     var opts = {};
 
@@ -47,10 +43,6 @@ export default class OptionManager {
     return opts;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addConfig(loc, key?, json=json5) {
     if (this.resolvedConfigs.indexOf(loc) >= 0) return;
 
@@ -69,10 +61,6 @@ export default class OptionManager {
     this.resolvedConfigs.push(loc);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   mergeOptions(opts, alias = "foreign") {
     if (!opts) return;
 
@@ -92,10 +80,6 @@ export default class OptionManager {
     merge(this.options, opts);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addIgnoreConfig(loc) {
     var file  = fs.readFileSync(loc, "utf8");
     var lines = file.split("\n");
@@ -132,10 +116,6 @@ export default class OptionManager {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   normaliseOptions() {
     var opts = this.options;
 
@@ -165,10 +145,6 @@ export default class OptionManager {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   init(opts) {
     this.mergeOptions(opts, "direct");
 
diff --git a/packages/babel-core/src/transformation/file/options/parsers.js b/packages/babel-core/src/transformation/file/options/parsers.js
index 18e920b9c2..4738bc9b53 100644
--- a/packages/babel-core/src/transformation/file/options/parsers.js
+++ b/packages/babel-core/src/transformation/file/options/parsers.js
@@ -35,10 +35,6 @@ export function number(val) {
 
 export var filename = slash;
 
-/**
- * [Please add a description.]
- */
-
 export function boolean(val) {
   return !!val;
 }
diff --git a/packages/babel-core/src/transformation/file/plugin-manager.js b/packages/babel-core/src/transformation/file/plugin-manager.js
index 1bf5695825..5486c53550 100644
--- a/packages/babel-core/src/transformation/file/plugin-manager.js
+++ b/packages/babel-core/src/transformation/file/plugin-manager.js
@@ -6,10 +6,6 @@ import resolve from "try-resolve";
 import traverse from "babel-traverse";
 import parse from "../../helpers/parse";
 
-/**
- * [Please add a description.]
- */
-
 var context = {
   messages,
   Transformer,
@@ -19,22 +15,9 @@ var context = {
   traverse
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class PluginManager {
-
-  /**
-   * [Please add a description.]
-   */
-
   static memoisedPlugins = [];
 
-  /**
-   * [Please add a description.]
-   */
-
   static memoisePluginContainer(fn) {
     for (var i = 0; i < PluginManager.memoisedPlugins.length; i++) {
       var plugin = PluginManager.memoisedPlugins[i];
@@ -49,16 +32,8 @@ export default class PluginManager {
     return transformer;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   static positions = ["before", "after"];
 
-  /**
-   * [Please add a description.]
-   */
-
   constructor({ file, transformers, before, after } = { transformers: {}, before: [], after: [] }) {
     this.transformers = transformers;
     this.file         = file;
@@ -66,10 +41,6 @@ export default class PluginManager {
     this.after        = after;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   subnormaliseString(name, position) {
     // this is a plugin in the form of "foobar" or "foobar:after"
     // where the optional colon is the delimiter for plugin position in the transformer stack
@@ -89,10 +60,6 @@ export default class PluginManager {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   validate(name, plugin) {
     // validate transformer key
     var key = plugin.key;
@@ -109,10 +76,6 @@ export default class PluginManager {
     plugin.metadata.plugin = true;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   add(name) {
     var position;
     var plugin;
diff --git a/packages/babel-core/src/transformation/helpers/README.md b/packages/babel-core/src/transformation/helpers/README.md
deleted file mode 100644
index 79afe09210..0000000000
--- a/packages/babel-core/src/transformation/helpers/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Transformation Helpers
-
-This is the Transformation Helpers directory.
diff --git a/packages/babel-core/src/transformation/helpers/build-binary-assignment-operator-transformer.js b/packages/babel-core/src/transformation/helpers/build-binary-assignment-operator-transformer.js
index 914578c47f..015c949fa2 100644
--- a/packages/babel-core/src/transformation/helpers/build-binary-assignment-operator-transformer.js
+++ b/packages/babel-core/src/transformation/helpers/build-binary-assignment-operator-transformer.js
@@ -1,33 +1,17 @@
 import explode from "./explode-assignable-expression";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function (opts) {
   var exports = {};
 
-  /**
-   * [Please add a description.]
-   */
-
   var isAssignment = function (node) {
     return node.operator === opts.operator + "=";
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   var buildAssignment = function (left, right) {
     return t.assignmentExpression("=", left, right);
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   exports.ExpressionStatement = function (node, parent, scope, file) {
     // hit the `AssignmentExpression` one below
     if (this.isCompletionRecord()) return;
@@ -45,10 +29,6 @@ export default function (opts) {
     return nodes;
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   exports.AssignmentExpression = function (node, parent, scope, file) {
     if (!isAssignment(node)) return;
 
@@ -58,10 +38,6 @@ export default function (opts) {
     return nodes;
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   exports.BinaryExpression = function (node) {
     if (node.operator !== opts.operator) return;
     return opts.build(node.left, node.right);
diff --git a/packages/babel-core/src/transformation/helpers/build-comprehension.js b/packages/babel-core/src/transformation/helpers/build-comprehension.js
index 73d1b24535..3c491cc15c 100644
--- a/packages/babel-core/src/transformation/helpers/build-comprehension.js
+++ b/packages/babel-core/src/transformation/helpers/build-comprehension.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function build(node, buildBody) {
   var self = node.blocks.shift();
   if (!self) return;
diff --git a/packages/babel-core/src/transformation/helpers/build-conditional-assignment-operator-transformer.js b/packages/babel-core/src/transformation/helpers/build-conditional-assignment-operator-transformer.js
index 78fe1b00bc..e99a374332 100644
--- a/packages/babel-core/src/transformation/helpers/build-conditional-assignment-operator-transformer.js
+++ b/packages/babel-core/src/transformation/helpers/build-conditional-assignment-operator-transformer.js
@@ -1,24 +1,11 @@
 import explode from "./explode-assignable-expression";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function (exports, opts) {
-
-  /**
-   * [Please add a description.]
-   */
-
   var buildAssignment = function (left, right) {
     return t.assignmentExpression("=", left, right);
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   exports.ExpressionStatement = function (node, parent, scope, file) {
     // hit the `AssignmentExpression` one below
     if (this.isCompletionRecord()) return;
@@ -38,10 +25,6 @@ export default function (exports, opts) {
     return nodes;
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   exports.AssignmentExpression = function (node, parent, scope, file) {
     if (!opts.is(node, file)) return;
 
diff --git a/packages/babel-core/src/transformation/helpers/build-react-transformer.js b/packages/babel-core/src/transformation/helpers/build-react-transformer.js
index 437a8a5f51..dc77ac2b2a 100644
--- a/packages/babel-core/src/transformation/helpers/build-react-transformer.js
+++ b/packages/babel-core/src/transformation/helpers/build-react-transformer.js
@@ -9,17 +9,9 @@ import esutils from "esutils";
 import { react } from "babel-types";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function (opts) {
   var visitor = {};
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXIdentifier = function (node) {
     if (node.name === "this" && this.isReferenced()) {
       return t.thisExpression();
@@ -30,18 +22,10 @@ export default function (opts) {
     }
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXNamespacedName = function () {
     throw this.errorWithNode(messages.get("JSXNamespacedTags"));
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXMemberExpression = {
     exit(node) {
       node.computed = t.isLiteral(node.property);
@@ -49,18 +33,10 @@ export default function (opts) {
     }
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXExpressionContainer = function (node) {
     return node.expression;
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXAttribute = {
     enter(node) {
       var value = node.value;
@@ -75,10 +51,6 @@ export default function (opts) {
     }
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXOpeningElement = {
     exit(node, parent, scope, file) {
       parent.children = react.buildChildren(parent);
@@ -169,10 +141,6 @@ export default function (opts) {
     return attribs;
   };
 
-  /**
-   * [Please add a description.]
-   */
-
   visitor.JSXElement = {
     exit(node) {
       var callExpr = node.openingElement;
diff --git a/packages/babel-core/src/transformation/helpers/call-delegate.js b/packages/babel-core/src/transformation/helpers/call-delegate.js
index 5a840417d3..20dde54340 100644
--- a/packages/babel-core/src/transformation/helpers/call-delegate.js
+++ b/packages/babel-core/src/transformation/helpers/call-delegate.js
@@ -1,15 +1,6 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   enter(node, parent, scope, state) {
     if (this.isThisExpression() || this.isReferencedIdentifier({ name: "arguments" })) {
       state.found = true;
@@ -17,19 +8,11 @@ var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     this.skip();
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default function (node, scope) {
   var container = t.functionExpression(null, [], node.body, node.generator, node.async);
 
diff --git a/packages/babel-core/src/transformation/helpers/define-map.js b/packages/babel-core/src/transformation/helpers/define-map.js
index e7e52f0d0e..ab7325b897 100644
--- a/packages/babel-core/src/transformation/helpers/define-map.js
+++ b/packages/babel-core/src/transformation/helpers/define-map.js
@@ -2,10 +2,6 @@ import each from "lodash/collection/each";
 import has from "lodash/object/has";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export function push(mutatorMap, node, kind, file) {
   var alias = t.toKeyAlias(node);
 
@@ -47,10 +43,6 @@ export function push(mutatorMap, node, kind, file) {
   return map;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function hasComputed(mutatorMap) {
   for (var key in mutatorMap) {
     if (mutatorMap[key]._computed) {
@@ -60,10 +52,6 @@ export function hasComputed(mutatorMap) {
   return false;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toComputedObjectFromClass(obj) {
   var objExpr = t.arrayExpression([]);
 
@@ -77,10 +65,6 @@ export function toComputedObjectFromClass(obj) {
   return objExpr;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toClassObject(mutatorMap) {
   var objExpr = t.objectExpression([]);
 
@@ -108,10 +92,6 @@ export function toClassObject(mutatorMap) {
   return objExpr;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toDefineObject(mutatorMap) {
   each(mutatorMap, function (map) {
     if (map.value) map.writable = t.booleanLiteral(true);
diff --git a/packages/babel-core/src/transformation/helpers/explode-assignable-expression.js b/packages/babel-core/src/transformation/helpers/explode-assignable-expression.js
index 206552f7aa..c89388616c 100644
--- a/packages/babel-core/src/transformation/helpers/explode-assignable-expression.js
+++ b/packages/babel-core/src/transformation/helpers/explode-assignable-expression.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var getObjRef = function (node, nodes, file, scope) {
   var ref;
   if (t.isIdentifier(node)) {
@@ -37,10 +33,6 @@ var getObjRef = function (node, nodes, file, scope) {
   return temp;
 };
 
-/**
- * [Please add a description.]
- */
-
 var getPropRef = function (node, nodes, file, scope) {
   var prop = node.property;
   var key = t.toComputedKey(node, prop);
@@ -53,10 +45,6 @@ var getPropRef = function (node, nodes, file, scope) {
   return temp;
 };
 
-/**
- * [Please add a description.]
- */
-
 export default function (node, nodes, file, scope, allowedSingleIdent) {
   var obj;
   if (t.isIdentifier(node) && allowedSingleIdent) {
diff --git a/packages/babel-core/src/transformation/helpers/get-function-arity.js b/packages/babel-core/src/transformation/helpers/get-function-arity.js
index 6be07752a7..ce66f57207 100644
--- a/packages/babel-core/src/transformation/helpers/get-function-arity.js
+++ b/packages/babel-core/src/transformation/helpers/get-function-arity.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function (node) {
   for (var i = 0; i < node.params.length; i++) {
     var param = node.params[i];
diff --git a/packages/babel-core/src/transformation/helpers/memoise-decorators.js b/packages/babel-core/src/transformation/helpers/memoise-decorators.js
index 1e3cbdaba5..1764781df9 100644
--- a/packages/babel-core/src/transformation/helpers/memoise-decorators.js
+++ b/packages/babel-core/src/transformation/helpers/memoise-decorators.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function (decorators, scope) {
   for (var i = 0; i < decorators.length; i++) {
     var decorator = decorators[i];
diff --git a/packages/babel-core/src/transformation/helpers/name-method.js b/packages/babel-core/src/transformation/helpers/name-method.js
index 5d99781c39..90cd1d0ec1 100644
--- a/packages/babel-core/src/transformation/helpers/name-method.js
+++ b/packages/babel-core/src/transformation/helpers/name-method.js
@@ -2,10 +2,6 @@ import getFunctionArity from "./get-function-arity";
 import * as util from  "../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function visitIdentifier(context, node, scope, state) {
   // check if this node matches our function id
   if (node.name !== state.name) return;
@@ -19,33 +15,16 @@ function visitIdentifier(context, node, scope, state) {
   context.stop();
 }
 
-/**
- * [Please add a description.]
- */
-
 var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     visitIdentifier(this, node, scope, state);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   BindingIdentifier(node, parent, scope, state) {
     visitIdentifier(this, node, scope, state);
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var wrap = function (state, method, id, scope) {
   if (state.selfReference) {
     if (scope.hasBinding(id.name) && !scope.hasGlobal(id.name)) {
@@ -77,10 +56,6 @@ var wrap = function (state, method, id, scope) {
   scope.getProgramParent().references[id.name] = true;
 };
 
-/**
- * [Please add a description.]
- */
-
 var visit = function (node, name, scope) {
   var state = {
     selfAssignment: false,
@@ -127,19 +102,11 @@ var visit = function (node, name, scope) {
   return state;
 };
 
-/**
- * [Please add a description.]
- */
-
 export function custom(node, id, scope) {
   var state = visit(node, id.name, scope);
   return wrap(state, node, id, scope);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function property(node, file, scope) {
   var key = t.toComputedKey(node, node.key);
   if (!t.isLiteral(key)) return; // we can't set a function id with this
@@ -152,10 +119,6 @@ export function property(node, file, scope) {
   node.value = wrap(state, method, id, scope) || method;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function bare(node, parent, scope) {
   // has an `id` so we don't need to infer one
   if (node.id) return;
diff --git a/packages/babel-core/src/transformation/helpers/regex.js b/packages/babel-core/src/transformation/helpers/regex.js
index 0f6ac2edb0..012775591e 100644
--- a/packages/babel-core/src/transformation/helpers/regex.js
+++ b/packages/babel-core/src/transformation/helpers/regex.js
@@ -1,18 +1,10 @@
 import pull from "lodash/array/pull";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export function is(node, flag) {
   return t.isRegexLiteral(node) && node.flags.indexOf(flag) >= 0;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function pullFlag(node, flag) {
   var flags = node.flags.split("");
   if (node.flags.indexOf(flag) < 0) return;
diff --git a/packages/babel-core/src/transformation/helpers/remap-async-to-generator.js b/packages/babel-core/src/transformation/helpers/remap-async-to-generator.js
index 52695a1894..c74dacd9e8 100644
--- a/packages/babel-core/src/transformation/helpers/remap-async-to-generator.js
+++ b/packages/babel-core/src/transformation/helpers/remap-async-to-generator.js
@@ -1,23 +1,10 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var awaitVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   AwaitExpression(node) {
     node.type = "YieldExpression";
 
@@ -29,16 +16,7 @@ var awaitVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var referenceVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     var name = state.id.name;
     if (node.name === name && scope.bindingIdentifierEquals(name, state.id)) {
@@ -47,10 +25,6 @@ var referenceVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default function (path, callId) {
   var node = path.node;
 
diff --git a/packages/babel-core/src/transformation/helpers/replace-supers.js b/packages/babel-core/src/transformation/helpers/replace-supers.js
index 4ac5170a52..7e0391a5be 100644
--- a/packages/babel-core/src/transformation/helpers/replace-supers.js
+++ b/packages/babel-core/src/transformation/helpers/replace-supers.js
@@ -2,10 +2,6 @@ import type NodePath from "../../traversal/path";
 import * as messages from "babel-messages";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function isIllegalBareSuper(node, parent) {
   if (!t.isSuper(node)) return false;
   if (t.isMemberExpression(parent, { computed: false })) return false;
@@ -13,24 +9,11 @@ function isIllegalBareSuper(node, parent) {
   return true;
 }
 
-/**
- * [Please add a description.]
- */
-
 function isMemberExpressionSuper(node) {
   return t.isMemberExpression(node) && t.isSuper(node.object);
 }
 
-/**
- * [Please add a description.]
- */
-
 var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   enter(node, parent, scope, state) {
     var topLevel = state.topLevel;
     var self = state.self;
@@ -61,10 +44,6 @@ var visitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class ReplaceSupers {
   constructor(opts: Object, inClass?: boolean = false) {
     this.topLevelThisReference = opts.topLevelThisReference;
@@ -80,10 +59,6 @@ export default class ReplaceSupers {
     this.opts                  = opts;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getObjectRef() {
     return this.opts.objectRef || this.opts.getObjectRef();
   }
@@ -139,27 +114,15 @@ export default class ReplaceSupers {
     );
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   replace() {
     this.traverseLevel(this.methodPath.get("value"), true);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   traverseLevel(path: NodePath, topLevel: boolean) {
     var state = { self: this, topLevel: topLevel };
     path.traverse(visitor, state);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getThisReference() {
     if (this.topLevelThisReference) {
       return this.topLevelThisReference;
@@ -172,10 +135,6 @@ export default class ReplaceSupers {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getLooseSuperProperty(id: Object, parent: Object) {
     var methodNode = this.methodNode;
     var methodName = methodNode.key;
@@ -215,10 +174,6 @@ export default class ReplaceSupers {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   looseHandle(path: NodePath, getThisReference: Function) {
     var node = path.node;
     if (path.isSuper()) {
@@ -235,10 +190,6 @@ export default class ReplaceSupers {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   specHandleAssignmentExpression(ref, path, node, getThisReference) {
     if (node.operator === "=") {
       // super.name = "val"; -> _set(Object.getPrototypeOf(objectRef.prototype), "name", this);
@@ -257,10 +208,6 @@ export default class ReplaceSupers {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   specHandle(path: NodePath, getThisReference: Function) {
     var methodNode = this.methodNode;
     var property;
diff --git a/packages/babel-core/src/transformation/index.js b/packages/babel-core/src/transformation/index.js
index ace35aa71c..383b9205af 100644
--- a/packages/babel-core/src/transformation/index.js
+++ b/packages/babel-core/src/transformation/index.js
@@ -1,15 +1,7 @@
 import Pipeline from "./pipeline";
 
-/**
- * [Please add a description.]
- */
-
 var pipeline = new Pipeline;
 
-/**
- * [Please add a description.]
- */
-
 import transformers from "./transformers";
 
 for (var key in transformers) {
@@ -23,24 +15,12 @@ for (var key in transformers) {
 
 pipeline.addTransformers(transformers);
 
-/**
- * [Please add a description.]
- */
-
 import deprecated from "./transformers/deprecated";
 pipeline.addDeprecated(deprecated);
 
-/**
- * [Please add a description.]
- */
-
 import aliases from "./transformers/aliases";
 pipeline.addAliases(aliases);
 
-/**
- * [Please add a description.]
- */
-
 import * as filters from "./transformers/filters";
 pipeline.addFilter(filters.internal);
 pipeline.addFilter(filters.blacklist);
@@ -48,10 +28,6 @@ pipeline.addFilter(filters.whitelist);
 pipeline.addFilter(filters.stage);
 pipeline.addFilter(filters.optional);
 
-/**
- * [Please add a description.]
- */
-
 var transform = pipeline.transform.bind(pipeline);
 transform.fromAst = pipeline.transformFromAst.bind(pipeline);
 transform.lint = pipeline.lint.bind(pipeline);
diff --git a/packages/babel-core/src/transformation/modules/README.md b/packages/babel-core/src/transformation/modules/README.md
deleted file mode 100644
index 75ededeec9..0000000000
--- a/packages/babel-core/src/transformation/modules/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Module Transformation
-
-This is the Module Transformation directory.
diff --git a/packages/babel-core/src/transformation/modules/_default.js b/packages/babel-core/src/transformation/modules/_default.js
index 1ec137ceaf..8968597181 100644
--- a/packages/babel-core/src/transformation/modules/_default.js
+++ b/packages/babel-core/src/transformation/modules/_default.js
@@ -4,10 +4,6 @@ import Remaps from "./lib/remaps";
 import * as util from  "../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class DefaultFormatter {
   constructor(file) {
     // object containg all module sources with the scope that they're contained in
@@ -35,10 +31,6 @@ export default class DefaultFormatter {
     this.getMetadata();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addScope(path) {
     var source = path.node.source && path.node.source.value;
     if (!source) return;
@@ -51,35 +43,19 @@ export default class DefaultFormatter {
     this.sourceScopes[source] = path.scope;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   isModuleType(node, type) {
     var modules = this.file.dynamicImportTypes[type];
     return modules && modules.indexOf(node) >= 0;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   transform() {
     this.remapAssignments();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   doDefaultExportInterop(node) {
     return (t.isExportDefaultDeclaration(node) || t.isSpecifierDefault(node)) && !this.noInteropRequireExport && !this.hasNonDefaultExports;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getMetadata() {
     var has = false;
     for (var node of (this.file.ast.program.body: Array)) {
@@ -93,20 +69,12 @@ export default class DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   remapAssignments() {
     if (this.hasLocalExports || this.hasLocalImports) {
       this.remaps.run();
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   remapExportAssignment(node, exported) {
     var assign = node;
 
@@ -121,10 +89,6 @@ export default class DefaultFormatter {
     return assign;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _addExport(name, exported) {
     var info = this.localExports[name] = this.localExports[name] || {
       binding: this.scope.getBindingIdentifier(name),
@@ -133,10 +97,6 @@ export default class DefaultFormatter {
     info.exported.push(exported);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getExport(node, scope) {
     if (!t.isIdentifier(node)) return;
 
@@ -146,10 +106,6 @@ export default class DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getModuleName() {
     var opts = this.file.opts;
     // moduleId is n/a if a `getModuleId()` is provided
@@ -192,10 +148,6 @@ export default class DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _pushStatement(ref, nodes) {
     if (t.isClass(ref) || t.isFunction(ref)) {
       if (ref.id) {
@@ -207,10 +159,6 @@ export default class DefaultFormatter {
     return ref;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _hoistExport(declar, assign, priority) {
     if (t.isFunctionDeclaration(declar)) {
       assign._blockHoist = priority || 2;
@@ -219,10 +167,6 @@ export default class DefaultFormatter {
     return assign;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getExternalReference(node, nodes) {
     var ids = this.ids;
     var id = node.source.value;
@@ -234,37 +178,21 @@ export default class DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   checkExportIdentifier(node) {
     if (t.isIdentifier(node, { name: "__esModule" })) {
       throw this.file.errorWithNode(node, messages.get("modulesIllegalExportName", node.name));
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportAllDeclaration(node, nodes) {
     var ref = this.getExternalReference(node, nodes);
     nodes.push(this.buildExportsWildcard(ref, node));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   isLoose() {
     return this.file.isLoose("es6.modules");
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportSpecifier(specifier, node, nodes) {
     if (node.source) {
       var ref = this.getExternalReference(node, nodes);
@@ -289,10 +217,6 @@ export default class DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildExportsWildcard(objectIdentifier) {
     return t.expressionStatement(t.callExpression(this.file.addHelper("defaults"), [
       t.identifier("exports"),
@@ -303,10 +227,6 @@ export default class DefaultFormatter {
     ]));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildExportsFromAssignment(id, init) {
     this.checkExportIdentifier(id);
     return util.template("exports-from-assign", {
@@ -315,10 +235,6 @@ export default class DefaultFormatter {
     }, true);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildExportsAssignment(id, init) {
     this.checkExportIdentifier(id);
     return util.template("exports-assign", {
@@ -327,10 +243,6 @@ export default class DefaultFormatter {
     }, true);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportDeclaration(node, nodes) {
     var declar = node.declaration;
 
diff --git a/packages/babel-core/src/transformation/modules/_strict.js b/packages/babel-core/src/transformation/modules/_strict.js
index 89adae51f5..02c8aba004 100644
--- a/packages/babel-core/src/transformation/modules/_strict.js
+++ b/packages/babel-core/src/transformation/modules/_strict.js
@@ -1,9 +1,5 @@
 import * as util from "../../util";
 
-/**
- * [Please add a description.]
- */
-
 export default function (Parent) {
   var Constructor = function () {
     this.noInteropRequireImport = true;
diff --git a/packages/babel-core/src/transformation/modules/amd-strict.js b/packages/babel-core/src/transformation/modules/amd-strict.js
index 53341c61de..d3dc3d6745 100644
--- a/packages/babel-core/src/transformation/modules/amd-strict.js
+++ b/packages/babel-core/src/transformation/modules/amd-strict.js
@@ -1,8 +1,4 @@
 import AMDFormatter from "./amd";
 import buildStrict from "./_strict";
 
-/**
- * [Please add a description.]
- */
-
 export default buildStrict(AMDFormatter);
diff --git a/packages/babel-core/src/transformation/modules/amd.js b/packages/babel-core/src/transformation/modules/amd.js
index a363f2c673..3a5f5c4341 100644
--- a/packages/babel-core/src/transformation/modules/amd.js
+++ b/packages/babel-core/src/transformation/modules/amd.js
@@ -5,24 +5,11 @@ import values from "lodash/object/values";
 import * as util from  "../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class AMDFormatter extends DefaultFormatter {
-
-  /**
-   * [Please add a description.]
-   */
-
   setup() {
     CommonFormatter.prototype._setup.call(this, this.hasNonDefaultExports);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildDependencyLiterals() {
     var names = [];
     for (var name in this.ids) {
@@ -77,26 +64,14 @@ export default class AMDFormatter extends DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _getExternalReference(node) {
     return this.scope.generateUidIdentifier(node.source.value);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   importDeclaration(node) {
     this.getExternalReference(node);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   importSpecifier(specifier, node, nodes, scope) {
     var key = node.source.value;
     var ref = this.getExternalReference(node);
@@ -130,10 +105,6 @@ export default class AMDFormatter extends DefaultFormatter {
     this.remaps.add(scope, specifier.local.name, ref);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportSpecifier(specifier, node, nodes) {
     if (this.doDefaultExportInterop(specifier)) {
       this.passModuleArg = true;
@@ -149,10 +120,6 @@ export default class AMDFormatter extends DefaultFormatter {
     CommonFormatter.prototype.exportSpecifier.apply(this, arguments);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportDeclaration(node, nodes) {
     if (this.doDefaultExportInterop(node)) {
       this.passModuleArg = true;
diff --git a/packages/babel-core/src/transformation/modules/common-strict.js b/packages/babel-core/src/transformation/modules/common-strict.js
index 729348386c..19c2837aa1 100644
--- a/packages/babel-core/src/transformation/modules/common-strict.js
+++ b/packages/babel-core/src/transformation/modules/common-strict.js
@@ -1,8 +1,4 @@
 import CommonFormatter from "./common";
 import buildStrict from "./_strict";
 
-/**
- * [Please add a description.]
- */
-
 export default buildStrict(CommonFormatter);
diff --git a/packages/babel-core/src/transformation/modules/common.js b/packages/babel-core/src/transformation/modules/common.js
index 9bda6661f4..b6b18acf0c 100644
--- a/packages/babel-core/src/transformation/modules/common.js
+++ b/packages/babel-core/src/transformation/modules/common.js
@@ -2,24 +2,11 @@ import DefaultFormatter from "./_default";
 import * as util from  "../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class CommonJSFormatter extends DefaultFormatter {
-
-  /**
-   * [Please add a description.]
-   */
-
   setup() {
     this._setup(this.hasLocalExports);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _setup(conditional) {
     var file  = this.file;
     var scope = file.scope;
@@ -36,10 +23,6 @@ export default class CommonJSFormatter extends DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   transform(program) {
     DefaultFormatter.prototype.transform.apply(this, arguments);
 
@@ -54,10 +37,6 @@ export default class CommonJSFormatter extends DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   importSpecifier(specifier, node, nodes, scope) {
     var variableName = specifier.local;
 
@@ -98,10 +77,6 @@ export default class CommonJSFormatter extends DefaultFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   importDeclaration(node, nodes) {
     // import "foo";
     nodes.push(util.template("require", {
@@ -109,10 +84,6 @@ export default class CommonJSFormatter extends DefaultFormatter {
     }, true));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportSpecifier(specifier) {
     if (this.doDefaultExportInterop(specifier)) {
       this.hasDefaultOnlyExport = true;
@@ -121,10 +92,6 @@ export default class CommonJSFormatter extends DefaultFormatter {
     DefaultFormatter.prototype.exportSpecifier.apply(this, arguments);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportDeclaration(node) {
     if (this.doDefaultExportInterop(node)) {
       this.hasDefaultOnlyExport = true;
@@ -133,10 +100,6 @@ export default class CommonJSFormatter extends DefaultFormatter {
     DefaultFormatter.prototype.exportDeclaration.apply(this, arguments);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _getExternalReference(node, nodes) {
     var call = t.callExpression(t.identifier("require"), [node.source]);
     var uid;
diff --git a/packages/babel-core/src/transformation/modules/ignore.js b/packages/babel-core/src/transformation/modules/ignore.js
index ed349bed46..aaef9dfb27 100644
--- a/packages/babel-core/src/transformation/modules/ignore.js
+++ b/packages/babel-core/src/transformation/modules/ignore.js
@@ -1,25 +1,12 @@
 import DefaultFormatter from "./_default";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class IgnoreFormatter extends DefaultFormatter {
-
-  /**
-   * [Please add a description.]
-   */
-
   exportDeclaration(node, nodes) {
     var declar = t.toStatement(node.declaration, true);
     if (declar) nodes.push(t.inherits(declar, node));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   exportAllDeclaration() {}
   importDeclaration() {}
   importSpecifier() {}
diff --git a/packages/babel-core/src/transformation/modules/lib/metadata.js b/packages/babel-core/src/transformation/modules/lib/metadata.js
index a8fa21f990..e22f9aa0a0 100644
--- a/packages/babel-core/src/transformation/modules/lib/metadata.js
+++ b/packages/babel-core/src/transformation/modules/lib/metadata.js
@@ -1,10 +1,6 @@
 import extend from "lodash/object/extend";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export var ModuleDeclaration = {
   enter(node, parent, scope, formatter) {
     if (node.source) {
@@ -14,10 +10,6 @@ export var ModuleDeclaration = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var ImportDeclaration = {
   exit(node, parent, scope, formatter) {
     formatter.hasLocalImports = true;
@@ -66,10 +58,6 @@ export var ImportDeclaration = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export function ExportDeclaration(node, parent, scope, formatter) {
   formatter.hasLocalExports = true;
 
@@ -163,10 +151,6 @@ export function ExportDeclaration(node, parent, scope, formatter) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function Scope(node, parent, scope, formatter) {
   if (!formatter.isLoose()) {
     this.skip();
diff --git a/packages/babel-core/src/transformation/modules/lib/remaps.js b/packages/babel-core/src/transformation/modules/lib/remaps.js
index 859ac818d6..dcd4737124 100644
--- a/packages/babel-core/src/transformation/modules/lib/remaps.js
+++ b/packages/babel-core/src/transformation/modules/lib/remaps.js
@@ -1,25 +1,12 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var remapVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   enter(node) {
     if (node._skipModulesRemap) {
       return this.skip();
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, remaps) {
     var { formatter } = remaps;
 
@@ -36,10 +23,6 @@ var remapVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   AssignmentExpression: {
     exit(node, parent, scope, { formatter }) {
       if (!node._ignoreModulesRemap) {
@@ -51,10 +34,6 @@ var remapVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   UpdateExpression(node, parent, scope, { formatter }) {
     var exported = formatter.getExport(node.argument, scope);
     if (!exported) return;
@@ -87,44 +66,24 @@ var remapVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class Remaps {
   constructor(file, formatter) {
     this.formatter = formatter;
     this.file      = file;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   run() {
     this.file.path.traverse(remapVisitor, this);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _getKey(name) {
     return `${name}:moduleRemap`;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   get(scope, name) {
     return scope.getData(this._getKey(name));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   add(scope, name, val) {
     if (this.all) {
       this.all.push({
@@ -137,10 +96,6 @@ export default class Remaps {
     return scope.setData(this._getKey(name), val);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   remove(scope, name) {
     return scope.removeData(this._getKey(name));
   }
@@ -155,10 +110,6 @@ export default class Remaps {
     return this.all;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   clearAll() {
     if (this.all) {
       for (var remap of (this.all: Array)) {
diff --git a/packages/babel-core/src/transformation/modules/system.js b/packages/babel-core/src/transformation/modules/system.js
index 1729b8e66e..1b2e327c2e 100644
--- a/packages/babel-core/src/transformation/modules/system.js
+++ b/packages/babel-core/src/transformation/modules/system.js
@@ -5,25 +5,12 @@ import last from "lodash/array/last";
 import map from "lodash/collection/map";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var hoistVariablesVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     // nothing inside is accessible
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   VariableDeclaration(node, parent, scope, state) {
     if (node.kind !== "var" && !t.isProgram(parent)) { // let, const
       // can't be accessed
@@ -54,24 +41,11 @@ var hoistVariablesVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var hoistFunctionsVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   enter(node, parent, scope, state) {
     if (t.isFunctionDeclaration(node) || state.formatter._canHoist(node)) {
       state.handlerBody.push(node);
@@ -80,16 +54,7 @@ var hoistFunctionsVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var runnerSettersVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   enter(node, parent, scope, state) {
     if (node._importSource === state.source) {
       if (t.isVariableDeclaration(node)) {
@@ -108,10 +73,6 @@ var runnerSettersVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class SystemFormatter extends AMDFormatter {
   constructor(file) {
     super(file);
@@ -124,19 +85,11 @@ export default class SystemFormatter extends AMDFormatter {
     this.remaps.clearAll();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _addImportSource(node, exportNode) {
     if (node) node._importSource = exportNode.source && exportNode.source.value;
     return node;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildExportsWildcard(objectIdentifier, node) {
     var leftIdentifier = this.scope.generateUidIdentifier("key");
     var valIdentifier  = t.memberExpression(objectIdentifier, leftIdentifier, true);
@@ -157,27 +110,15 @@ export default class SystemFormatter extends AMDFormatter {
     return this._addImportSource(t.forInStatement(left, right, block), node);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildExportsAssignment(id, init, node) {
     var call = this._buildExportCall(t.stringLiteral(id.name), init, true);
     return this._addImportSource(call, node);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildExportsFromAssignment() {
     return this.buildExportsAssignment(...arguments);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   remapExportAssignment(node, exported) {
     var assign = node;
 
@@ -188,10 +129,6 @@ export default class SystemFormatter extends AMDFormatter {
     return assign;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _buildExportCall(id, init, isStatement) {
     var call = t.callExpression(this.exportIdentifier, [id, init]);
     if (isStatement) {
@@ -201,10 +138,6 @@ export default class SystemFormatter extends AMDFormatter {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   importSpecifier(specifier, node, nodes) {
     AMDFormatter.prototype.importSpecifier.apply(this, arguments);
 
@@ -219,10 +152,6 @@ export default class SystemFormatter extends AMDFormatter {
     this._addImportSource(last(nodes), node);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _buildRunnerSetters(block, hoistDeclarators) {
     var scope = this.file.scope;
 
@@ -239,18 +168,10 @@ export default class SystemFormatter extends AMDFormatter {
     }));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _canHoist(node) {
     return node._blockHoist && !this.file.dynamicImports.length;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   transform(program) {
     DefaultFormatter.prototype.transform.apply(this, arguments);
 
diff --git a/packages/babel-core/src/transformation/modules/umd-strict.js b/packages/babel-core/src/transformation/modules/umd-strict.js
index 250a015037..f929e475dc 100644
--- a/packages/babel-core/src/transformation/modules/umd-strict.js
+++ b/packages/babel-core/src/transformation/modules/umd-strict.js
@@ -1,8 +1,4 @@
 import UMDFormatter from "./umd";
 import buildStrict from "./_strict";
 
-/**
- * [Please add a description.]
- */
-
 export default buildStrict(UMDFormatter);
diff --git a/packages/babel-core/src/transformation/modules/umd.js b/packages/babel-core/src/transformation/modules/umd.js
index 5f8557836a..a6f83c1911 100644
--- a/packages/babel-core/src/transformation/modules/umd.js
+++ b/packages/babel-core/src/transformation/modules/umd.js
@@ -5,16 +5,7 @@ import path from "path";
 import * as util from  "../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class UMDFormatter extends AMDFormatter {
-
-  /**
-   * [Please add a description.]
-   */
-
   transform(program) {
     DefaultFormatter.prototype.transform.apply(this, arguments);
 
diff --git a/packages/babel-core/src/transformation/pipeline.js b/packages/babel-core/src/transformation/pipeline.js
index 0e72a5325c..dbfbbc8774 100644
--- a/packages/babel-core/src/transformation/pipeline.js
+++ b/packages/babel-core/src/transformation/pipeline.js
@@ -4,10 +4,6 @@ import Plugin from "./plugin";
 import assign from "lodash/object/assign";
 import File from "./file";
 
-/**
- * [Please add a description.]
- */
-
 export default class Pipeline {
   transformers = Object.create(null);
   namespaces   = Object.create(null);
@@ -15,10 +11,6 @@ export default class Pipeline {
   aliases      = Object.create(null);
   filters      = [];
 
-  /**
-   * [Please add a description.]
-   */
-
   addTransformers(transformers) {
     for (var key in transformers) {
       this.addTransformer(key, transformers[key]);
@@ -26,10 +18,6 @@ export default class Pipeline {
     return this;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addTransformer(key, plugin) {
     if (this.transformers[key]) throw new Error(); // todo: error
 
@@ -53,37 +41,21 @@ export default class Pipeline {
     this.transformers[key] = plugin;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addAliases(names) {
     assign(this.aliases, names);
     return this;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addDeprecated(names) {
     assign(this.deprecated, names);
     return this;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addFilter(filter: Function) {
     this.filters.push(filter);
     return this;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   canRun(plugin, fileOpts) {
     if (plugin.metadata.plugin) {
       return true;
@@ -97,10 +69,6 @@ export default class Pipeline {
     return true;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   lint(code: string, opts?: Object = {}) {
     opts.code = false;
     opts.mode = "lint";
@@ -120,10 +88,6 @@ export default class Pipeline {
     });
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   transform(code: string, opts?: Object) {
     var file = new File(opts, this);
     return file.wrap(code, function () {
@@ -133,10 +97,6 @@ export default class Pipeline {
     });
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   transformFromAst(ast, code, opts) {
     ast = normalizeAst(ast);
 
@@ -148,10 +108,6 @@ export default class Pipeline {
     });
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _ensureTransformerNames(type: string, rawKeys: Array<string>) {
     var keys = [];
 
diff --git a/packages/babel-core/src/transformation/plugin-pass.js b/packages/babel-core/src/transformation/plugin-pass.js
index 02488d9755..f8b02f26e1 100644
--- a/packages/babel-core/src/transformation/plugin-pass.js
+++ b/packages/babel-core/src/transformation/plugin-pass.js
@@ -20,10 +20,6 @@ export default class PluginPass {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   canTransform(): boolean {
     if (this.plugin.metadata.mode !== this.file.opts.mode) {
       return false;
@@ -32,19 +28,11 @@ export default class PluginPass {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   canRun() {
     return this.file.transformerDependencies[this.key] ||
            this.file.pipeline.canRun(this.plugin, this.file.opts);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   transform() {
     var file = this.file;
     file.log.debug(`Start transformer ${this.key}`);
diff --git a/packages/babel-core/src/transformation/plugin.js b/packages/babel-core/src/transformation/plugin.js
index e0724d5df6..f5d37db0bb 100644
--- a/packages/babel-core/src/transformation/plugin.js
+++ b/packages/babel-core/src/transformation/plugin.js
@@ -22,10 +22,6 @@ const VALID_METADATA_PROPERTES = [
   "mode"
 ];
 
-/**
- * [Please add a description.]
- */
-
 export default class Plugin {
   constructor(key: string, plugin: Object) {
     Plugin.validate(key, plugin);
@@ -56,10 +52,6 @@ export default class Plugin {
     this.key     = key;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   static validate(name, plugin) {
     for (let key in plugin) {
       if (key[0] === "_") continue;
@@ -77,19 +69,11 @@ export default class Plugin {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   normalize(visitor: Object): Object {
     traverse.explode(visitor);
     return visitor;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildPass(file: File): PluginPass {
     // validate Transformer instance
     if (!(file instanceof File)) {
diff --git a/packages/babel-core/src/transformation/transformers/README.md b/packages/babel-core/src/transformation/transformers/README.md
deleted file mode 100644
index 6005d15209..0000000000
--- a/packages/babel-core/src/transformation/transformers/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Transformers
-
-This is the Transformers directory.
diff --git a/packages/babel-core/src/transformation/transformers/es3/member-expression-literals.js b/packages/babel-core/src/transformation/transformers/es3/member-expression-literals.js
index 0cb9484779..d3d838f45a 100644
--- a/packages/babel-core/src/transformation/transformers/es3/member-expression-literals.js
+++ b/packages/babel-core/src/transformation/transformers/es3/member-expression-literals.js
@@ -23,7 +23,6 @@ export var metadata = {
  */
 
 export var visitor = {
-
   /**
    * Look for non-computed properties with names that are not valid identifiers.
    * Turn them into computed properties with literal names.
diff --git a/packages/babel-core/src/transformation/transformers/es3/property-literals.js b/packages/babel-core/src/transformation/transformers/es3/property-literals.js
index dc629a2663..a134e915b8 100644
--- a/packages/babel-core/src/transformation/transformers/es3/property-literals.js
+++ b/packages/babel-core/src/transformation/transformers/es3/property-literals.js
@@ -25,7 +25,6 @@ export var metadata = {
  */
 
 export var visitor = {
-
   /**
    * Look for non-computed keys with names that are not valid identifiers.
    * Turn them into literals.
@@ -36,7 +35,7 @@ export var visitor = {
       var key = node.key;
       if (!node.computed && t.isIdentifier(key) && !t.isValidIdentifier(key.name)) {
         // default: "bar" -> "default": "bar"
-        node.key = t.literal(key.name);
+        node.key = t.stringLiteral(key.name);
       }
     }
   }
diff --git a/packages/babel-core/src/transformation/transformers/es5/properties.mutators.js b/packages/babel-core/src/transformation/transformers/es5/properties.mutators.js
index 75ad9b43ee..d326bdf0b8 100644
--- a/packages/babel-core/src/transformation/transformers/es5/properties.mutators.js
+++ b/packages/babel-core/src/transformation/transformers/es5/properties.mutators.js
@@ -31,7 +31,6 @@ import * as t from "babel-types";
  */
 
 export var visitor = {
-
   /**
    * Look for getters and setters on an object.
    * Filter them out and wrap the object with an `Object.defineProperties` that
diff --git a/packages/babel-core/src/transformation/transformers/es6/arrow-functions.js b/packages/babel-core/src/transformation/transformers/es6/arrow-functions.js
index c9e2ba6538..659d4fa12a 100644
--- a/packages/babel-core/src/transformation/transformers/es6/arrow-functions.js
+++ b/packages/babel-core/src/transformation/transformers/es6/arrow-functions.js
@@ -18,7 +18,6 @@
  */
 
 export var visitor = {
-
   /**
    * Look for arrow functions and mark them as "shadow functions".
    * @see /transformation/transformers/internal/shadow-functions.js
diff --git a/packages/babel-core/src/transformation/transformers/es6/block-scoping/index.js b/packages/babel-core/src/transformation/transformers/es6/block-scoping/index.js
index cb86b1c521..ecea15cf41 100644
--- a/packages/babel-core/src/transformation/transformers/es6/block-scoping/index.js
+++ b/packages/babel-core/src/transformation/transformers/es6/block-scoping/index.js
@@ -8,10 +8,6 @@ import * as t from "babel-types";
 import values from "lodash/object/values";
 import extend from "lodash/object/extend";
 
-/**
- * [Please add a description.]
- */
-
 function isLet(node, parent) {
   if (!t.isVariableDeclaration(node)) return false;
   if (node._let) return true;
@@ -30,26 +26,14 @@ function isLet(node, parent) {
   return true;
 }
 
-/**
- * [Please add a description.]
- */
-
 function isLetInitable(node, parent) {
   return !t.isFor(parent) || !t.isFor(parent, { left: node });
 }
 
-/**
- * [Please add a description.]
- */
-
 function isVar(node, parent) {
   return t.isVariableDeclaration(node, { kind: "var" }) && !isLet(node, parent);
 }
 
-/**
- * [Please add a description.]
- */
-
 function standardizeLets(declars) {
   for (var declar of (declars: Array)) {
     delete declar._let;
@@ -60,16 +44,7 @@ export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   VariableDeclaration(node, parent, scope, file) {
     if (!isLet(node, parent)) return;
 
@@ -98,10 +73,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Loop(node, parent, scope, file) {
     var init = node.left || node.init;
     if (isLet(init, node)) {
@@ -113,10 +84,6 @@ export var visitor = {
     return blockScoping.run();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   "BlockStatement|Program"(block, parent, scope, file) {
     if (!t.isLoop(parent)) {
       var blockScoping = new BlockScoping(null, this, parent, scope, file);
@@ -125,10 +92,6 @@ export var visitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 function replace(node, parent, scope, remaps) {
   var remap = remaps[node.name];
   if (!remap) return;
@@ -143,17 +106,9 @@ function replace(node, parent, scope, remaps) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 var replaceVisitor = {
   ReferencedIdentifier: replace,
 
-  /**
-   * [Please add a description.]
-   */
-
   AssignmentExpression(node, parent, scope, remaps) {
     var ids = this.getBindingIdentifiers();
     for (var name in ids) {
@@ -162,10 +117,6 @@ var replaceVisitor = {
   },
 };
 
-/**
- * [Please add a description.]
- */
-
 function traverseReplace(node, parent, scope, remaps) {
   if (t.isIdentifier(node)) {
     replace(node, parent, scope, remaps);
@@ -181,32 +132,14 @@ function traverseReplace(node, parent, scope, remaps) {
   scope.traverse(node, replaceVisitor, remaps);
 }
 
-/**
- * [Please add a description.]
- */
-
 var letReferenceBlockVisitor = traverse.visitors.merge([{
-
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, state) {
     this.traverse(letReferenceFunctionVisitor, state);
     return this.skip();
   }
 }, tdzVisitor]);
 
-/**
- * [Please add a description.]
- */
-
 var letReferenceFunctionVisitor = traverse.visitors.merge([{
-
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     var ref = state.letReferences[node.name];
 
@@ -222,10 +155,6 @@ var letReferenceFunctionVisitor = traverse.visitors.merge([{
   }
 }, tdzVisitor]);
 
-/**
- * [Please add a description.]
- */
-
 var hoistVarDeclarationsVisitor = {
   enter(node, parent, scope, self) {
     if (this.isForStatement()) {
@@ -250,20 +179,12 @@ var hoistVarDeclarationsVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var loopLabelVisitor = {
   LabeledStatement(node, parent, scope, state) {
     state.innerLabels.push(node.label.name);
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var continuationVisitor = {
   enter(node, parent, scope, state) {
     if (this.isAssignmentExpression() || this.isUpdateExpression()) {
@@ -276,10 +197,6 @@ var continuationVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 function loopNodeTo(node) {
   if (t.isBreakStatement(node)) {
     return "break";
@@ -288,16 +205,7 @@ function loopNodeTo(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 var loopVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Loop(node, parent, scope, state) {
     var oldIgnoreLabeless = state.ignoreLabeless;
     state.ignoreLabeless = true;
@@ -306,18 +214,10 @@ var loopVisitor = {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   SwitchCase(node, parent, scope, state) {
     var oldInSwitchCase = state.inSwitchCase;
     state.inSwitchCase = true;
@@ -326,10 +226,6 @@ var loopVisitor = {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   "BreakStatement|ContinueStatement|ReturnStatement"(node, parent, scope, state) {
     var replace;
     var loopText = loopNodeTo(node);
@@ -374,10 +270,6 @@ var loopVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 class BlockScoping {
   constructor(loopPath?: NodePath, blockPath: NodePath, parent: Object, scope: Scope, file: File) {
     this.parent = parent;
@@ -428,10 +320,6 @@ class BlockScoping {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   remap() {
     var hasRemaps = false;
     var letRefs   = this.letReferences;
@@ -475,10 +363,6 @@ class BlockScoping {
     this.blockPath.traverse(replaceVisitor, remaps);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   wrapClosure() {
     var block = this.block;
 
@@ -595,10 +479,6 @@ class BlockScoping {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getLetReferences() {
     var block = this.block;
 
@@ -652,11 +532,9 @@ class BlockScoping {
    * the following node types `ReturnStatement`, `BreakStatement`,
    * `ContinueStatement` and replace it with a return value that we can track
    * later on.
-   *
-   * @returns {Object}
    */
 
-  checkLoop() {
+  checkLoop(): Object {
     var state = {
       hasBreakContinue: false,
       ignoreLabeless:   false,
@@ -709,10 +587,6 @@ class BlockScoping {
     return replace;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildHas(ret: { type: "Identifier" }, call: { type: "CallExpression" }) {
     var body = this.body;
 
diff --git a/packages/babel-core/src/transformation/transformers/es6/block-scoping/tdz.js b/packages/babel-core/src/transformation/transformers/es6/block-scoping/tdz.js
index 3f1bc87573..cdd254fc62 100644
--- a/packages/babel-core/src/transformation/transformers/es6/block-scoping/tdz.js
+++ b/packages/babel-core/src/transformation/transformers/es6/block-scoping/tdz.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function getTDZStatus(refPath, bindingPath) {
   var executionStatus = bindingPath._guessExecutionStatusRelativeTo(refPath);
 
@@ -16,10 +12,6 @@ function getTDZStatus(refPath, bindingPath) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function buildTDZAssert(node, file) {
   return t.callExpression(
     file.addHelper("temporal-assert-defined"),
@@ -27,10 +19,6 @@ function buildTDZAssert(node, file) {
   );
 }
 
-/**
- * [Please add a description.]
- */
-
 function isReference(node, scope, state) {
   var declared = state.letReferences[node.name];
   if (!declared) return false;
@@ -40,11 +28,6 @@ function isReference(node, scope, state) {
 }
 
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     if (t.isFor(parent, { left: node })) return;
     if (!isReference(node, scope, state)) return;
@@ -78,10 +61,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   AssignmentExpression: {
     exit(node, parent, scope, state) {
       if (node._ignoreBlockScopingTDZ) return;
diff --git a/packages/babel-core/src/transformation/transformers/es6/classes/index.js b/packages/babel-core/src/transformation/transformers/es6/classes/index.js
index 281d7a9fdf..da21f8f9a2 100644
--- a/packages/babel-core/src/transformation/transformers/es6/classes/index.js
+++ b/packages/babel-core/src/transformation/transformers/es6/classes/index.js
@@ -3,25 +3,13 @@ import VanillaTransformer from "./vanilla";
 import * as t from "babel-types";
 import { bare } from "../../../helpers/name-method";
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ClassDeclaration(node) {
     return t.variableDeclaration("let", [
       t.variableDeclarator(node.id, t.toExpression(node))
     ]);
   },
 
-  /**
-   * [Please add a description.]
-   */
 
   ClassExpression(node, parent, scope, file) {
     var inferred = bare(node, parent, scope);
diff --git a/packages/babel-core/src/transformation/transformers/es6/classes/loose.js b/packages/babel-core/src/transformation/transformers/es6/classes/loose.js
index f1e9c04a0a..10f7b2e622 100644
--- a/packages/babel-core/src/transformation/transformers/es6/classes/loose.js
+++ b/packages/babel-core/src/transformation/transformers/es6/classes/loose.js
@@ -1,20 +1,12 @@
 import VanillaTransformer from "./vanilla";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class LooseClassTransformer extends VanillaTransformer {
   constructor() {
     super(...arguments);
     this.isLoose = true;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _processMethod(node) {
     if (!node.decorators) {
       // use assignments instead of define properties for loose classes
diff --git a/packages/babel-core/src/transformation/transformers/es6/classes/vanilla.js b/packages/babel-core/src/transformation/transformers/es6/classes/vanilla.js
index 5776312fde..6e0f4ab1b3 100644
--- a/packages/babel-core/src/transformation/transformers/es6/classes/vanilla.js
+++ b/packages/babel-core/src/transformation/transformers/es6/classes/vanilla.js
@@ -10,16 +10,7 @@ import * as t from "babel-types";
 
 const PROPERTY_COLLISION_METHOD_NAME = "__initializeProperties";
 
-/**
- * [Please add a description.]
- */
-
 var collectPropertyReferencesVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Identifier: {
     enter(node, parent, scope, state) {
       if (this.parentPath.isClassProperty({ key: node })) {
@@ -33,32 +24,15 @@ var collectPropertyReferencesVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var verifyConstructorVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   MethodDefinition() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Property(node) {
     if (node.method) this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   CallExpression: {
     exit(node, parent, scope, state) {
       if (this.get("callee").isSuper()) {
@@ -72,18 +46,10 @@ var verifyConstructorVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   "FunctionDeclaration|FunctionExpression"() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ThisExpression(node, parent, scope, state) {
     if (state.isDerived && !state.hasBareSuper) {
       if (this.inShadow()) {
@@ -104,10 +70,6 @@ var verifyConstructorVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Super(node, parent, scope, state) {
     if (state.isDerived && !state.hasBareSuper && !this.parentPath.isCallExpression({ callee: node })) {
       throw this.errorWithNode("'super.*' is not allowed before super()");
@@ -115,10 +77,6 @@ var verifyConstructorVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class ClassTransformer {
   constructor(path: NodePath, file: File) {
     this.parent = path.parent;
@@ -152,18 +110,10 @@ export default class ClassTransformer {
     this.isDerived = !!this.node.superClass;
   }
 
-  /**
-   * [Please add a description.]
-   * @returns {Array}
-   */
-
   run() {
     var superName = this.superName;
     var file      = this.file;
-
-    //
-
-    var body = this.body;
+    var body      = this.body;
 
     //
 
@@ -221,20 +171,12 @@ export default class ClassTransformer {
     return t.callExpression(container, closureArgs);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildConstructor() {
     var func = t.functionDeclaration(this.classRef, [], this.constructorBody);
     t.inherits(func, this.node);
     return func;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushToMap(node, enumerable, kind = "value") {
     var mutatorMap;
     if (node.static) {
@@ -284,10 +226,6 @@ export default class ClassTransformer {
     ));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildBody() {
     this.constructorMeMaybe();
     this.pushBody();
@@ -303,10 +241,6 @@ export default class ClassTransformer {
     this.pushDescriptors();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushBody() {
     var classBodyPaths = this.path.get("body.body");
 
@@ -345,10 +279,6 @@ export default class ClassTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   clearDescriptors() {
     this.hasInstanceDescriptors = false;
     this.hasStaticDescriptors   = false;
@@ -357,10 +287,6 @@ export default class ClassTransformer {
     this.staticMutatorMap   = {};
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushDescriptors() {
     this.pushInherits();
 
@@ -416,20 +342,12 @@ export default class ClassTransformer {
     this.clearDescriptors();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildObjectAssignment(id) {
     return t.variableDeclaration("var", [
       t.variableDeclarator(id, t.objectExpression([]))
     ]);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   placePropertyInitializers() {
     var body = this.instancePropBody;
     if (!body.length) return;
@@ -459,10 +377,6 @@ export default class ClassTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
    hasPropertyCollision(): boolean {
     if (this.userConstructorPath) {
       for (var name in this.instancePropRefs) {
@@ -475,10 +389,6 @@ export default class ClassTransformer {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
    verifyConstructor(path: NodePath) {
     var state = {
       constructorPath: path.get("value"),
@@ -521,18 +431,10 @@ export default class ClassTransformer {
     this.pushToMap(node);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _processMethod() {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushProperty(node: { type: "ClassProperty" }, path: NodePath) {
     path.traverse(collectPropertyReferencesVisitor, {
       references: this.instancePropRefs,
@@ -613,10 +515,6 @@ export default class ClassTransformer {
     this._pushConstructor();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _pushConstructor() {
     if (this.pushedConstructor) return;
     this.pushedConstructor = true;
diff --git a/packages/babel-core/src/transformation/transformers/es6/constants.js b/packages/babel-core/src/transformation/transformers/es6/constants.js
index 4b0825c9f3..b4e5b0a171 100644
--- a/packages/babel-core/src/transformation/transformers/es6/constants.js
+++ b/packages/babel-core/src/transformation/transformers/es6/constants.js
@@ -20,7 +20,6 @@ import * as messages from "babel-messages";
  */
 
 export var visitor = {
-
   /**
    * Look for any constants (or modules) in scope.
    * If they have any `constantViolations` throw an error.
diff --git a/packages/babel-core/src/transformation/transformers/es6/destructuring.js b/packages/babel-core/src/transformation/transformers/es6/destructuring.js
index b7eee7a1a4..22efa3ce6d 100644
--- a/packages/babel-core/src/transformation/transformers/es6/destructuring.js
+++ b/packages/babel-core/src/transformation/transformers/es6/destructuring.js
@@ -5,16 +5,7 @@ export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ForXStatement(node, parent, scope, file) {
     var left = node.left;
 
@@ -63,10 +54,6 @@ export var visitor = {
     block.body = nodes.concat(block.body);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, file) {
     var hasDestructuring = false;
     for (let pattern of (node.params: Array)) {
@@ -111,10 +98,6 @@ export var visitor = {
     block.body = nodes.concat(block.body);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   CatchClause(node, parent, scope, file) {
     var pattern = node.param;
     if (!t.isPattern(pattern)) return;
@@ -135,10 +118,6 @@ export var visitor = {
     node.body.body = nodes.concat(node.body.body);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   AssignmentExpression(node, parent, scope, file) {
     if (!t.isPattern(node.left)) return;
 
@@ -173,10 +152,6 @@ export var visitor = {
     return nodes;
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   VariableDeclaration(node, parent, scope, file) {
     if (t.isForXStatement(parent)) return;
     if (!variableDeclarationHasPattern(node)) return;
@@ -260,16 +235,7 @@ function hasRest(pattern) {
   return false;
 }
 
-/**
- * [Please add a description.]
- */
-
 var arrayUnpackVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     if (state.bindings[node.name]) {
       state.deopt = true;
@@ -278,10 +244,6 @@ var arrayUnpackVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 class DestructuringTransformer {
   constructor(opts) {
     this.blockHoist = opts.blockHoist;
@@ -293,10 +255,6 @@ class DestructuringTransformer {
     this.kind       = opts.kind;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildVariableAssignment(id, init) {
     var op = this.operator;
     if (t.isMemberExpression(id)) op = "=";
@@ -316,10 +274,6 @@ class DestructuringTransformer {
     return node;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   buildVariableDeclaration(id, init) {
     var declar = t.variableDeclaration("var", [
       t.variableDeclarator(id, init)
@@ -328,10 +282,6 @@ class DestructuringTransformer {
     return declar;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   push(id, init) {
     if (t.isObjectPattern(id)) {
       this.pushObjectPattern(id, init);
@@ -344,10 +294,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   toArray(node, count) {
     if (this.file.isLoose("es6.destructuring") || (t.isIdentifier(node) && this.arrays[node.name])) {
       return node;
@@ -356,10 +302,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushAssignmentPattern(pattern, valueRef) {
     // we need to assign the current value of the assignment to avoid evaluating
     // it more than once
@@ -394,10 +336,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushObjectSpread(pattern, objRef, spreadProp, spreadPropIndex) {
     // get all the keys that appear in this object before the current spread
 
@@ -426,10 +364,6 @@ class DestructuringTransformer {
     this.nodes.push(this.buildVariableAssignment(spreadProp.argument, value));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushObjectProperty(prop, propRef) {
     if (t.isLiteral(prop.key)) prop.computed = true;
 
@@ -443,10 +377,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushObjectPattern(pattern, objRef) {
     // https://github.com/babel/babel/issues/681
 
@@ -478,10 +408,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   canUnpackArrayPattern(pattern, arr) {
     // not an array so there's no way we can deal with this
     if (!t.isArrayExpression(arr)) return false;
@@ -511,10 +437,6 @@ class DestructuringTransformer {
     return !state.deopt;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushUnpackedArrayPattern(pattern, arr) {
     for (var i = 0; i < pattern.elements.length; i++) {
       var elem = pattern.elements[i];
@@ -526,10 +448,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   pushArrayPattern(pattern, arrayRef) {
     if (!pattern.elements) return;
 
@@ -593,10 +511,6 @@ class DestructuringTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   init(pattern, ref) {
     // trying to destructure a value that we can't evaluate more than once so we
     // need to save it to a variable
diff --git a/packages/babel-core/src/transformation/transformers/es6/for-of.js b/packages/babel-core/src/transformation/transformers/es6/for-of.js
index 41fe945cfd..fea662b0ce 100644
--- a/packages/babel-core/src/transformation/transformers/es6/for-of.js
+++ b/packages/babel-core/src/transformation/transformers/es6/for-of.js
@@ -2,16 +2,7 @@ import * as messages from "babel-messages";
 import * as util from  "../../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ForOfStatement(node, parent, scope, file) {
     if (this.get("right").isArrayExpression()) {
       return _ForOfStatementArray.call(this, node, scope, file);
@@ -48,10 +39,6 @@ export var visitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export function _ForOfStatementArray(node, scope) {
   var nodes = [];
   var right = node.right;
@@ -94,10 +81,6 @@ export function _ForOfStatementArray(node, scope) {
   return nodes;
 }
 
-/**
- * [Please add a description.]
- */
-
 var loose = function (node, parent, scope, file) {
   var left = node.left;
   var declar, id;
@@ -141,10 +124,6 @@ var loose = function (node, parent, scope, file) {
   };
 };
 
-/**
- * [Please add a description.]
- */
-
 var spec = function (node, parent, scope, file) {
   var left = node.left;
   var declar;
diff --git a/packages/babel-core/src/transformation/transformers/es6/modules.js b/packages/babel-core/src/transformation/transformers/es6/modules.js
index f83ae730f0..287439c1dd 100644
--- a/packages/babel-core/src/transformation/transformers/es6/modules.js
+++ b/packages/babel-core/src/transformation/transformers/es6/modules.js
@@ -12,16 +12,7 @@ export var metadata = {
   group: "builtin-modules"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ImportDeclaration(node, parent, scope, file) {
     // flow type
     if (node.importKind === "type" || node.importKind === "typeof") return;
@@ -44,10 +35,6 @@ export var visitor = {
     return nodes;
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ExportAllDeclaration(node, parent, scope, file) {
     var nodes = [];
     file.moduleFormatter.exportAllDeclaration(node, nodes, scope);
@@ -55,10 +42,6 @@ export var visitor = {
     return nodes;
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ExportDefaultDeclaration(node, parent, scope, file) {
     var nodes = [];
     file.moduleFormatter.exportDeclaration(node, nodes, scope);
@@ -66,10 +49,6 @@ export var visitor = {
     return nodes;
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ExportNamedDeclaration(node, parent, scope, file) {
     // flow type
     if (this.get("declaration").isTypeAlias()) return;
diff --git a/packages/babel-core/src/transformation/transformers/es6/object-super.js b/packages/babel-core/src/transformation/transformers/es6/object-super.js
index 450ed3319d..f3afd17552 100644
--- a/packages/babel-core/src/transformation/transformers/es6/object-super.js
+++ b/packages/babel-core/src/transformation/transformers/es6/object-super.js
@@ -1,10 +1,6 @@
 import ReplaceSupers from "../../helpers/replace-supers";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function Property(path, node, scope, getObjectRef, file) {
   if (!node.method && node.kind === "init") return;
   if (!t.isFunction(node.value)) return;
@@ -21,16 +17,7 @@ function Property(path, node, scope, getObjectRef, file) {
   replaceSupers.replace();
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ObjectExpression(node, parent, scope, file) {
     var objectRef;
     var getObjectRef = () => objectRef = objectRef || scope.generateUidIdentifier("obj");
diff --git a/packages/babel-core/src/transformation/transformers/es6/parameters/default.js b/packages/babel-core/src/transformation/transformers/es6/parameters/default.js
index 717acd2e43..6ab7978e43 100644
--- a/packages/babel-core/src/transformation/transformers/es6/parameters/default.js
+++ b/packages/babel-core/src/transformation/transformers/es6/parameters/default.js
@@ -3,10 +3,6 @@ import getFunctionArity from "../../../helpers/get-function-arity";
 import * as util from  "../../../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var hasDefaults = function (node) {
   for (var i = 0; i < node.params.length; i++) {
     if (!t.isIdentifier(node.params[i])) return true;
@@ -14,16 +10,7 @@ var hasDefaults = function (node) {
   return false;
 };
 
-/**
- * [Please add a description.]
- */
-
 var iifeVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     if (node.name !== "eval") {
       if (!state.scope.hasOwnBinding(node.name)) return;
@@ -35,16 +22,7 @@ var iifeVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, file) {
     if (!hasDefaults(node)) return;
 
diff --git a/packages/babel-core/src/transformation/transformers/es6/parameters/index.js b/packages/babel-core/src/transformation/transformers/es6/parameters/index.js
index 17eea2f42a..e1061a0b68 100644
--- a/packages/babel-core/src/transformation/transformers/es6/parameters/index.js
+++ b/packages/babel-core/src/transformation/transformers/es6/parameters/index.js
@@ -7,8 +7,4 @@ export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = visitors.merge([rest.visitor, def.visitor]);
diff --git a/packages/babel-core/src/transformation/transformers/es6/parameters/rest.js b/packages/babel-core/src/transformation/transformers/es6/parameters/rest.js
index 738ac00ebe..8142737a54 100644
--- a/packages/babel-core/src/transformation/transformers/es6/parameters/rest.js
+++ b/packages/babel-core/src/transformation/transformers/es6/parameters/rest.js
@@ -1,16 +1,7 @@
 import * as util from  "../../../../util";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var memberExpressionOptimisationVisitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Scope(node, parent, scope, state) {
     // check if this scope has a local binding that will shadow the rest parameter
     if (!scope.bindingIdentifierEquals(state.name, state.outerBinding)) {
@@ -18,19 +9,11 @@ var memberExpressionOptimisationVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Flow() {
     // don't touch reference in type annotations
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, state) {
     // skip over functions as whatever `arguments` we reference inside will refer
     // to the wrong function
@@ -41,10 +24,6 @@ var memberExpressionOptimisationVisitor = {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     // we can't guarantee the purity of arguments
     if (node.name === "arguments") {
@@ -93,10 +72,6 @@ var memberExpressionOptimisationVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 function optimiseMemberExpression(parent, offset) {
   if (offset === 0) return;
 
@@ -112,24 +87,11 @@ function optimiseMemberExpression(parent, offset) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function hasRest(node) {
   return t.isRestElement(node.params[node.params.length - 1]);
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope) {
     if (!hasRest(node)) return;
 
@@ -233,7 +195,7 @@ export var visitor = {
       loop._blockHoist = node.params.length + 1;
       node.body.body.unshift(loop);
     } else {
-      // perform allocation at the lowest common denominator of all references
+      // perform allocation at the lowest common ancestor of all references
       loop._blockHoist = 1;
 
       var target = this.getEarliestCommonAncestorFrom(state.references).getStatementParent();
diff --git a/packages/babel-core/src/transformation/transformers/es6/properties.computed.js b/packages/babel-core/src/transformation/transformers/es6/properties.computed.js
index 5ff8069d78..72e5a65b03 100644
--- a/packages/babel-core/src/transformation/transformers/es6/properties.computed.js
+++ b/packages/babel-core/src/transformation/transformers/es6/properties.computed.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function loose(node, body, objId) {
   for (var prop of (node.properties: Array)) {
     body.push(t.expressionStatement(
@@ -16,10 +12,6 @@ function loose(node, body, objId) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function spec(node, body, objId, initProps, file) {
   // add a simple assignment for all Symbol member expressions due to symbol polyfill limitations
   // otherwise use Object.defineProperty
@@ -53,16 +45,7 @@ function spec(node, body, objId, initProps, file) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ObjectExpression: {
     exit(node, parent, scope, file) {
       var hasComputed = false;
diff --git a/packages/babel-core/src/transformation/transformers/es6/properties.shorthand.js b/packages/babel-core/src/transformation/transformers/es6/properties.shorthand.js
index b989d49e6e..a6029287b3 100644
--- a/packages/babel-core/src/transformation/transformers/es6/properties.shorthand.js
+++ b/packages/babel-core/src/transformation/transformers/es6/properties.shorthand.js
@@ -3,11 +3,6 @@
  */
 
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Property(node) {
     if (node.method) {
       node.method = false;
diff --git a/packages/babel-core/src/transformation/transformers/es6/regex.sticky.js b/packages/babel-core/src/transformation/transformers/es6/regex.sticky.js
index f8958100ac..26efd93f0d 100644
--- a/packages/babel-core/src/transformation/transformers/es6/regex.sticky.js
+++ b/packages/babel-core/src/transformation/transformers/es6/regex.sticky.js
@@ -1,16 +1,7 @@
 import * as regex from "../../helpers/regex";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   RegexLiteral(node) {
     if (!regex.is(node, "y")) return;
     return t.newExpression(t.identifier("RegExp"), [
diff --git a/packages/babel-core/src/transformation/transformers/es6/regex.unicode.js b/packages/babel-core/src/transformation/transformers/es6/regex.unicode.js
index f67c4aedde..8bb2763c0c 100644
--- a/packages/babel-core/src/transformation/transformers/es6/regex.unicode.js
+++ b/packages/babel-core/src/transformation/transformers/es6/regex.unicode.js
@@ -1,16 +1,7 @@
 import rewritePattern from "regexpu/rewrite-pattern";
 import * as regex from "../../helpers/regex";
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   RegexLiteral(node) {
     if (!regex.is(node, "u")) return;
     node.regex.pattern = rewritePattern(node.pattern, node.flags);
diff --git a/packages/babel-core/src/transformation/transformers/es6/spec.symbols.js b/packages/babel-core/src/transformation/transformers/es6/spec.symbols.js
index 34354e5eb8..0886017864 100644
--- a/packages/babel-core/src/transformation/transformers/es6/spec.symbols.js
+++ b/packages/babel-core/src/transformation/transformers/es6/spec.symbols.js
@@ -4,16 +4,7 @@ export var metadata = {
   optional: true
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   UnaryExpression(node, parent, scope, file) {
     if (node._ignoreSpecSymbols) return;
 
@@ -40,20 +31,12 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   BinaryExpression(node, parent, scope, file) {
     if (node.operator === "instanceof") {
       return t.callExpression(file.addHelper("instanceof"), [node.left, node.right]);
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   "VariableDeclaration|FunctionDeclaration"(node) {
     if (node._generated) this.skip();
   }
diff --git a/packages/babel-core/src/transformation/transformers/es6/spec.template-literals.js b/packages/babel-core/src/transformation/transformers/es6/spec.template-literals.js
index d37ab172e3..7498b1820e 100644
--- a/packages/babel-core/src/transformation/transformers/es6/spec.template-literals.js
+++ b/packages/babel-core/src/transformation/transformers/es6/spec.template-literals.js
@@ -5,16 +5,7 @@ export var metadata = {
   group: "builtin-pre"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   TemplateLiteral(node, parent) {
     if (t.isTaggedTemplateExpression(parent)) return;
 
diff --git a/packages/babel-core/src/transformation/transformers/es6/spread.js b/packages/babel-core/src/transformation/transformers/es6/spread.js
index d3ea13b42c..a9e0c30ead 100644
--- a/packages/babel-core/src/transformation/transformers/es6/spread.js
+++ b/packages/babel-core/src/transformation/transformers/es6/spread.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function getSpreadLiteral(spread, scope) {
   if (scope.hub.file.isLoose("es6.spread") && !t.isIdentifier(spread.argument, { name: "arguments" })) {
     return spread.argument;
@@ -12,10 +8,6 @@ function getSpreadLiteral(spread, scope) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function hasSpread(nodes) {
   for (var i = 0; i < nodes.length; i++) {
     if (t.isSpreadElement(nodes[i])) {
@@ -25,10 +17,6 @@ function hasSpread(nodes) {
   return false;
 }
 
-/**
- * [Please add a description.]
- */
-
 function build(props, scope) {
   var nodes = [];
 
@@ -59,16 +47,7 @@ export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ArrayExpression(node, parent, scope) {
     var elements = node.elements;
     if (!hasSpread(elements)) return;
@@ -84,10 +63,6 @@ export var visitor = {
     return t.callExpression(t.memberExpression(first, t.identifier("concat")), nodes);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   CallExpression(node, parent, scope) {
     var args = node.arguments;
     if (!hasSpread(args)) return;
@@ -128,10 +103,6 @@ export var visitor = {
     node.arguments.unshift(contextLiteral);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   NewExpression(node, parent, scope, file) {
     var args = node.arguments;
     if (!hasSpread(args)) return;
diff --git a/packages/babel-core/src/transformation/transformers/es6/tail-call.js b/packages/babel-core/src/transformation/transformers/es6/tail-call.js
index b80b74f0ce..7715e1f935 100644
--- a/packages/babel-core/src/transformation/transformers/es6/tail-call.js
+++ b/packages/babel-core/src/transformation/transformers/es6/tail-call.js
@@ -9,16 +9,7 @@ export var metadata = {
   group: "builtin-trailing"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, file) {
     if (node.generator || node.async) return;
     var tailCall = new TailCallTransformer(this, scope, file);
@@ -26,24 +17,11 @@ export var visitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 function returnBlock(expr) {
   return t.blockStatement([t.returnStatement(expr)]);
 }
 
-/**
- * [Please add a description.]
- */
-
 var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   enter(node, parent) {
     if (t.isTryStatement(parent)) {
       if (node === parent.block) {
@@ -54,34 +32,18 @@ var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ReturnStatement(node, parent, scope, state) {
     return state.subTransform(node.argument);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   VariableDeclaration(node, parent, scope, state) {
     state.vars.push(node);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ThisExpression(node, parent, scope, state) {
     if (!state.isShadowed) {
       state.needsThis = true;
@@ -89,10 +51,6 @@ var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     if (node.name === "arguments" && (!state.isShadowed || node._shadowedFunctionLiteral)) {
       state.needsArguments = true;
@@ -101,10 +59,6 @@ var visitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 class TailCallTransformer {
   constructor(path, scope, file) {
     this.hasTailRecursion = false;
@@ -126,50 +80,26 @@ class TailCallTransformer {
     this.node  = path.node;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getArgumentsId() {
     return this.argumentsId = this.argumentsId || this.scope.generateUidIdentifier("arguments");
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getThisId() {
     return this.thisId = this.thisId || this.scope.generateUidIdentifier("this");
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getLeftId() {
     return this.leftId = this.leftId || this.scope.generateUidIdentifier("left");
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getFunctionId() {
     return this.functionId = this.functionId || this.scope.generateUidIdentifier("function");
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getAgainId() {
     return this.againId = this.againId || this.scope.generateUidIdentifier("again");
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getParams() {
     var params = this.params;
 
@@ -191,10 +121,6 @@ class TailCallTransformer {
     return this.params = params;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasDeopt() {
     // check if the ownerId has been reassigned, if it has then it's not safe to
     // perform optimisations
@@ -202,10 +128,6 @@ class TailCallTransformer {
     return ownerIdInfo && !ownerIdInfo.constant;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   run() {
     var node  = this.node;
 
@@ -304,10 +226,6 @@ class TailCallTransformer {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   subTransform(node) {
     if (!node) return;
 
@@ -315,10 +233,6 @@ class TailCallTransformer {
     if (handler) return handler.call(this, node);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   subTransformConditionalExpression(node) {
     var callConsequent = this.subTransform(node.consequent);
     var callAlternate = this.subTransform(node.alternate);
@@ -339,10 +253,6 @@ class TailCallTransformer {
     return [node];
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   subTransformLogicalExpression(node) {
     // only call in right-value of can be optimized
     var callRight = this.subTransform(node.right);
@@ -363,10 +273,6 @@ class TailCallTransformer {
     return [t.ifStatement(testExpr, returnBlock(leftId))].concat(callRight);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   subTransformSequenceExpression(node) {
     var seq = node.expressions;
 
@@ -385,10 +291,6 @@ class TailCallTransformer {
     return [t.expressionStatement(node)].concat(lastCall);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   subTransformCallExpression(node) {
     var callee = node.callee;
     var thisBinding, args;
diff --git a/packages/babel-core/src/transformation/transformers/es6/template-literals.js b/packages/babel-core/src/transformation/transformers/es6/template-literals.js
index 496d9927a8..f9fd7ab33e 100644
--- a/packages/babel-core/src/transformation/transformers/es6/template-literals.js
+++ b/packages/babel-core/src/transformation/transformers/es6/template-literals.js
@@ -6,28 +6,16 @@ export var metadata = {
   group: "builtin-pre"
 };
 
-/**
- * [Please add a description.]
- */
-
 function isString(node) {
   return t.isLiteral(node) && typeof node.value === "string";
 }
 
-/**
- * [Please add a description.]
- */
-
 function buildBinaryExpression(left, right) {
   var node = t.binaryExpression("+", left, right);
   node._templateLiteralProduced = true;
   return node;
 }
 
-/**
- * [Please add a description.]
- */
-
 function crawl(path) {
   if (path.is("_templateLiteralProduced")) {
     crawl(path.get("left"));
@@ -37,16 +25,7 @@ function crawl(path) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   TaggedTemplateExpression(node, parent, scope, file) {
     var quasi = node.quasi;
     var args  = [];
@@ -55,8 +34,8 @@ export var visitor = {
     var raw     = [];
 
     for (var elem of (quasi.quasis: Array)) {
-      strings.push(t.literal(elem.value.cooked));
-      raw.push(t.literal(elem.value.raw));
+      strings.push(t.stringLiteral(elem.value.cooked));
+      raw.push(t.stringLiteral(elem.value.raw));
     }
 
     strings = t.arrayExpression(strings);
@@ -73,15 +52,11 @@ export var visitor = {
     return t.callExpression(node.tag, args);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   TemplateLiteral(node, parent, scope, file) {
     var nodes = [];
 
     for (let elem of (node.quasis: Array)) {
-      nodes.push(t.literal(elem.value.cooked));
+      nodes.push(t.stringLiteral(elem.value.cooked));
 
       var expr = node.expressions.shift();
       if (expr) nodes.push(expr);
@@ -93,7 +68,7 @@ export var visitor = {
     // since `+` is left-to-right associative
     // ensure the first node is a string if first/second isn't
     if (!isString(nodes[0]) && !isString(nodes[1])) {
-      nodes.unshift(t.literal(""));
+      nodes.unshift(t.stringLiteral(""));
     }
 
     if (nodes.length > 1) {
diff --git a/packages/babel-core/src/transformation/transformers/es7/comprehensions.js b/packages/babel-core/src/transformation/transformers/es7/comprehensions.js
index 6f8d4d218f..0936429cef 100644
--- a/packages/babel-core/src/transformation/transformers/es7/comprehensions.js
+++ b/packages/babel-core/src/transformation/transformers/es7/comprehensions.js
@@ -7,16 +7,7 @@ export var metadata = {
   stage: 0
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ComprehensionExpression(node, parent, scope) {
     var callback = array;
     if (node.generator) callback = generator;
@@ -24,10 +15,6 @@ export var visitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 function generator(node) {
   var body = [];
   var container = t.functionExpression(null, [], t.blockStatement(body), true);
@@ -40,10 +27,6 @@ function generator(node) {
   return t.callExpression(container, []);
 }
 
-/**
- * [Please add a description.]
- */
-
 function array(node, parent, scope) {
   var uid = scope.generateUidIdentifierBasedOnNode(parent);
 
diff --git a/packages/babel-core/src/transformation/transformers/es7/decorators.js b/packages/babel-core/src/transformation/transformers/es7/decorators.js
index 9c4160bddb..b0fd12c146 100644
--- a/packages/babel-core/src/transformation/transformers/es7/decorators.js
+++ b/packages/babel-core/src/transformation/transformers/es7/decorators.js
@@ -8,16 +8,7 @@ export var metadata = {
   stage: 1
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ObjectExpression(node, parent, scope, file) {
     var hasDecorators = false;
     for (let i = 0; i < node.properties.length; i++) {
diff --git a/packages/babel-core/src/transformation/transformers/es7/do-expressions.js b/packages/babel-core/src/transformation/transformers/es7/do-expressions.js
index a26da279f5..f6aafc4f42 100644
--- a/packages/babel-core/src/transformation/transformers/es7/do-expressions.js
+++ b/packages/babel-core/src/transformation/transformers/es7/do-expressions.js
@@ -5,16 +5,7 @@ export var metadata = {
   stage: 0
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   DoExpression(node) {
     var body = node.body.body;
     if (body.length) {
diff --git a/packages/babel-core/src/transformation/transformers/es7/exponentiation-operator.js b/packages/babel-core/src/transformation/transformers/es7/exponentiation-operator.js
index 11a72314e2..6539ed6860 100644
--- a/packages/babel-core/src/transformation/transformers/es7/exponentiation-operator.js
+++ b/packages/babel-core/src/transformation/transformers/es7/exponentiation-operator.js
@@ -7,17 +7,9 @@ export var metadata = {
   stage: 2
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = build({
   operator: "**",
 
-  /**
-   * [Please add a description.]
-   */
-
   build(left, right) {
     return t.callExpression(t.memberExpression(t.identifier("Math"), t.identifier("pow")), [left, right]);
   }
diff --git a/packages/babel-core/src/transformation/transformers/es7/export-extensions.js b/packages/babel-core/src/transformation/transformers/es7/export-extensions.js
index db04f83ff5..2e622c2d56 100644
--- a/packages/babel-core/src/transformation/transformers/es7/export-extensions.js
+++ b/packages/babel-core/src/transformation/transformers/es7/export-extensions.js
@@ -6,10 +6,6 @@ export var metadata = {
   stage: 1
 };
 
-/**
- * [Please add a description.]
- */
-
 function build(node, nodes, scope) {
   var first = node.specifiers[0];
   if (!t.isExportNamespaceSpecifier(first) && !t.isExportDefaultSpecifier(first)) return;
@@ -30,16 +26,7 @@ function build(node, nodes, scope) {
   build(node, nodes, scope);
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ExportNamedDeclaration(node, parent, scope) {
     var nodes = [];
     build(node, nodes, scope);
diff --git a/packages/babel-core/src/transformation/transformers/es7/function-bind.js b/packages/babel-core/src/transformation/transformers/es7/function-bind.js
index 50f60d67f1..30f9ddf621 100644
--- a/packages/babel-core/src/transformation/transformers/es7/function-bind.js
+++ b/packages/babel-core/src/transformation/transformers/es7/function-bind.js
@@ -7,10 +7,6 @@ export var metadata = {
   stage: 0
 };
 
-/**
- * [Please add a description.]
- */
-
 function getTempId(scope) {
   var id = scope.path.getData("functionBind");
   if (id) return id;
@@ -19,19 +15,11 @@ function getTempId(scope) {
   return scope.path.setData("functionBind", id);
 }
 
-/**
- * [Please add a description.]
- */
-
 function getStaticContext(bind, scope) {
   var object = bind.object || bind.callee.object;
   return scope.isStatic(object) && object;
 }
 
-/**
- * [Please add a description.]
- */
-
 function inferBindContext(bind, scope) {
   var staticContext = getStaticContext(bind, scope);
   if (staticContext) return staticContext;
@@ -48,16 +36,7 @@ function inferBindContext(bind, scope) {
   return tempId;
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   CallExpression(node, parent, scope) {
     var bind = node.callee;
     if (!t.isBindExpression(bind)) return;
@@ -67,10 +46,6 @@ export var visitor = {
     node.arguments.unshift(context);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   BindExpression(node, parent, scope) {
     var context = inferBindContext(node, scope);
     return t.callExpression(t.memberExpression(node.callee, t.identifier("bind")), [context]);
diff --git a/packages/babel-core/src/transformation/transformers/es7/object-rest-spread.js b/packages/babel-core/src/transformation/transformers/es7/object-rest-spread.js
index ca21f36a78..932adb0118 100644
--- a/packages/babel-core/src/transformation/transformers/es7/object-rest-spread.js
+++ b/packages/babel-core/src/transformation/transformers/es7/object-rest-spread.js
@@ -7,10 +7,6 @@ export var metadata = {
   dependencies: ["es6.destructuring"]
 };
 
-/**
- * [Please add a description.]
- */
-
 var hasSpread = function (node) {
   for (var i = 0; i < node.properties.length; i++) {
     if (t.isSpreadProperty(node.properties[i])) {
@@ -20,16 +16,7 @@ var hasSpread = function (node) {
   return false;
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ObjectExpression(node, parent, scope, file) {
     if (!hasSpread(node)) return;
 
diff --git a/packages/babel-core/src/transformation/transformers/filters.js b/packages/babel-core/src/transformation/transformers/filters.js
index c4bdc8b35e..dff6631b9b 100644
--- a/packages/babel-core/src/transformation/transformers/filters.js
+++ b/packages/babel-core/src/transformation/transformers/filters.js
@@ -1,44 +1,24 @@
 import includes from "lodash/collection/includes";
 
-/**
- * [Please add a description.]
- */
-
 export function internal(transformer) {
   if (transformer.key[0] === "_") return true;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function blacklist(transformer, opts) {
   var blacklist = opts.blacklist;
   if (blacklist.length && includes(blacklist, transformer.key)) return false;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function whitelist(transformer, opts) {
   var whitelist = opts.whitelist;
   if (whitelist) return includes(whitelist, transformer.key);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function stage(transformer, opts) {
   var stage = transformer.metadata.stage;
   if (stage != null && stage >= opts.stage) return true;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function optional(transformer, opts) {
   if (transformer.metadata.optional && !includes(opts.optional, transformer.key)) return false;
 }
diff --git a/packages/babel-core/src/transformation/transformers/index.js b/packages/babel-core/src/transformation/transformers/index.js
index 250c6dbdf9..e9a3d7bf72 100644
--- a/packages/babel-core/src/transformation/transformers/index.js
+++ b/packages/babel-core/src/transformation/transformers/index.js
@@ -60,7 +60,6 @@ export default {
   "es6.parameters":                        require("./es6/parameters"),
   "es6.destructuring":                     require("./es6/destructuring"),
   "es6.blockScoping":                      require("./es6/block-scoping"),
-  "es6.spec.blockScoping":                 require("./es6/spec.block-scoping"),
   reactCompat:                             require("./other/react-compat"),
   react:                                   require("./other/react"),
   regenerator:                             require("./other/regenerator"),
diff --git a/packages/babel-core/src/transformation/transformers/internal/block-hoist.js b/packages/babel-core/src/transformation/transformers/internal/block-hoist.js
index 5cee32309e..567ad4a783 100644
--- a/packages/babel-core/src/transformation/transformers/internal/block-hoist.js
+++ b/packages/babel-core/src/transformation/transformers/internal/block-hoist.js
@@ -16,11 +16,6 @@ export var metadata = {
  */
 
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Block: {
     exit(node) {
       var hasChange = false;
diff --git a/packages/babel-core/src/transformation/transformers/internal/hoist-directives.js b/packages/babel-core/src/transformation/transformers/internal/hoist-directives.js
index 285e61b53b..74c9601515 100644
--- a/packages/babel-core/src/transformation/transformers/internal/hoist-directives.js
+++ b/packages/babel-core/src/transformation/transformers/internal/hoist-directives.js
@@ -4,16 +4,7 @@ export var metadata = {
   group: "builtin-pre"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Block: {
     exit(node) {
       for (var i = 0; i < node.body.length; i++) {
diff --git a/packages/babel-core/src/transformation/transformers/internal/module-formatter.js b/packages/babel-core/src/transformation/transformers/internal/module-formatter.js
index 27b34ac17c..d767376582 100644
--- a/packages/babel-core/src/transformation/transformers/internal/module-formatter.js
+++ b/packages/babel-core/src/transformation/transformers/internal/module-formatter.js
@@ -2,16 +2,7 @@ export var metadata = {
   group: "builtin-modules"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Program: {
     exit(program, parent, scope, file) {
       // ensure that these are at the top, just like normal imports
diff --git a/packages/babel-core/src/transformation/transformers/internal/modules.js b/packages/babel-core/src/transformation/transformers/internal/modules.js
index d11fdabe2e..340cc42893 100644
--- a/packages/babel-core/src/transformation/transformers/internal/modules.js
+++ b/packages/babel-core/src/transformation/transformers/internal/modules.js
@@ -6,10 +6,6 @@
 
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function getDeclar(node) {
   var declar = node.declaration;
   t.inheritsComments(declar, node);
@@ -18,10 +14,6 @@ function getDeclar(node) {
   return declar;
 }
 
-/**
- * [Please add a description.]
- */
-
 function buildExportSpecifier(id) {
   return t.exportSpecifier(cloneIdentifier(id), cloneIdentifier(id));
 }
@@ -36,16 +28,7 @@ export var metadata = {
   group: "builtin-pre"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ExportDefaultDeclaration(node, parent, scope) {
     var declar = node.declaration;
 
@@ -74,10 +57,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ExportNamedDeclaration(node) {
     var declar = node.declaration;
 
@@ -104,10 +83,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Program: {
     enter(node) {
       var imports = [];
diff --git a/packages/babel-core/src/transformation/transformers/internal/shadow-functions.js b/packages/babel-core/src/transformation/transformers/internal/shadow-functions.js
index a3f8cc5c62..b257211a1b 100644
--- a/packages/babel-core/src/transformation/transformers/internal/shadow-functions.js
+++ b/packages/babel-core/src/transformation/transformers/internal/shadow-functions.js
@@ -12,10 +12,6 @@ function shouldShadow(path, shadowPath) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function remap(path, key, create) {
   // ensure that we're shadowed
   var shadowPath = path.inShadow(key);
@@ -58,24 +54,11 @@ function remap(path, key, create) {
   return id;
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ThisExpression() {
     return remap(this, "this", () => t.thisExpression());
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node) {
     if (node.name === "arguments") {
       return remap(this, "arguments", () => t.identifier("arguments"));
diff --git a/packages/babel-core/src/transformation/transformers/internal/validation.js b/packages/babel-core/src/transformation/transformers/internal/validation.js
index 8aa0896e57..7704923a70 100644
--- a/packages/babel-core/src/transformation/transformers/internal/validation.js
+++ b/packages/babel-core/src/transformation/transformers/internal/validation.js
@@ -5,16 +5,7 @@ export var metadata = {
   group: "builtin-pre"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ForXStatement(node, parent, scope, file) {
     var left = node.left;
     if (t.isVariableDeclaration(left)) {
@@ -23,10 +14,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Property(node, parent, scope, file) {
     if (node.kind === "set") {
       var first = node.value.params[0];
diff --git a/packages/babel-core/src/transformation/transformers/optimisation/flow.for-of.js b/packages/babel-core/src/transformation/transformers/optimisation/flow.for-of.js
index d19e61800f..b5eeba6c62 100644
--- a/packages/babel-core/src/transformation/transformers/optimisation/flow.for-of.js
+++ b/packages/babel-core/src/transformation/transformers/optimisation/flow.for-of.js
@@ -4,16 +4,7 @@ export var metadata = {
   optional: true
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   ForOfStatement(node, parent, scope, file) {
     if (this.get("right").isGenericType("Array")) {
       return _ForOfStatementArray.call(this, node, scope, file);
diff --git a/packages/babel-core/src/transformation/transformers/optimisation/react.inline-elements.js b/packages/babel-core/src/transformation/transformers/optimisation/react.inline-elements.js
index 7a1046c985..6013f4772c 100644
--- a/packages/babel-core/src/transformation/transformers/optimisation/react.inline-elements.js
+++ b/packages/babel-core/src/transformation/transformers/optimisation/react.inline-elements.js
@@ -5,10 +5,6 @@ export var metadata = {
   optional: true
 };
 
-/**
- * [Please add a description.]
- */
-
 function hasRefOrSpread(attrs) {
   for (var i = 0; i < attrs.length; i++) {
     var attr = attrs[i];
@@ -18,23 +14,10 @@ function hasRefOrSpread(attrs) {
   return false;
 }
 
-/**
- * [Please add a description.]
- */
-
 function isJSXAttributeOfName(attr, name) {
   return t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name, { name: name });
 }
-
-/**
- * [Please add a description.]
- */
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   JSXElement(node, parent, scope, file) {
     // filter
     var open = node.openingElement;
diff --git a/packages/babel-core/src/transformation/transformers/other/async-to-generator.js b/packages/babel-core/src/transformation/transformers/other/async-to-generator.js
index f00724319c..844bfd0691 100644
--- a/packages/babel-core/src/transformation/transformers/other/async-to-generator.js
+++ b/packages/babel-core/src/transformation/transformers/other/async-to-generator.js
@@ -7,16 +7,7 @@ export var metadata = {
   dependencies: ["es7.asyncFunctions", "es6.classes"]
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, file) {
     if (!node.async || node.generator) return;
 
diff --git a/packages/babel-core/src/transformation/transformers/other/bluebird-coroutines.js b/packages/babel-core/src/transformation/transformers/other/bluebird-coroutines.js
index c2aa18ac3f..52cdc1b1e7 100644
--- a/packages/babel-core/src/transformation/transformers/other/bluebird-coroutines.js
+++ b/packages/babel-core/src/transformation/transformers/other/bluebird-coroutines.js
@@ -1,10 +1,6 @@
 import remapAsyncToGenerator from "../../helpers/remap-async-to-generator";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export function manipulateOptions(opts) {
   opts.blacklist.push("regenerator");
 }
@@ -14,16 +10,7 @@ export var metadata = {
   dependencies: ["es7.asyncFunctions", "es6.classes"]
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function(node, parent, scope, file) {
     if (!node.async || node.generator) return;
 
diff --git a/packages/babel-core/src/transformation/transformers/other/flow.js b/packages/babel-core/src/transformation/transformers/other/flow.js
index 8bba081d4b..515294be53 100644
--- a/packages/babel-core/src/transformation/transformers/other/flow.js
+++ b/packages/babel-core/src/transformation/transformers/other/flow.js
@@ -6,16 +6,7 @@ export var metadata = {
 
 const FLOW_DIRECTIVE = "@flow";
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Program(node, parent, scope, file) {
     for (var comment of (file.ast.comments: Array)) {
       if (comment.value.indexOf(FLOW_DIRECTIVE) >= 0) {
@@ -28,35 +19,19 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Flow() {
     this.dangerouslyRemove();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ClassProperty(node) {
     node.typeAnnotation = null;
     if (!node.value) this.dangerouslyRemove();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Class(node) {
     node.implements = null;
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Function(node) {
     for (var i = 0; i < node.params.length; i++) {
       var param = node.params[i];
@@ -64,10 +39,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   TypeCastExpression(node) {
     do {
       node = node.expression;
diff --git a/packages/babel-core/src/transformation/transformers/other/react-compat.js b/packages/babel-core/src/transformation/transformers/other/react-compat.js
index f18dc5e801..ed065009eb 100644
--- a/packages/babel-core/src/transformation/transformers/other/react-compat.js
+++ b/packages/babel-core/src/transformation/transformers/other/react-compat.js
@@ -1,10 +1,6 @@
 import { react } from "babel-types";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export function manipulateOptions(opts) {
   opts.blacklist.push("react");
 }
@@ -14,24 +10,11 @@ export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = require("../../helpers/build-react-transformer")({
-
-  /**
-   * [Please add a description.]
-   */
-
   pre(state) {
     state.callee = state.tagExpr;
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   post(state) {
     if (react.isCompatTag(state.tagName)) {
       state.call = t.callExpression(
diff --git a/packages/babel-core/src/transformation/transformers/other/react.js b/packages/babel-core/src/transformation/transformers/other/react.js
index 90d6c61e69..1345f842f2 100644
--- a/packages/babel-core/src/transformation/transformers/other/react.js
+++ b/packages/babel-core/src/transformation/transformers/other/react.js
@@ -1,26 +1,13 @@
 import { react } from "babel-types";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var JSX_ANNOTATION_REGEX = /^\*\s*@jsx\s+([^\s]+)/;
 
 export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = require("../../helpers/build-react-transformer")({
-
-  /**
-   * [Please add a description.]
-   */
-
   pre(state) {
     var tagName = state.tagName;
     var args    = state.args;
@@ -31,19 +18,11 @@ export var visitor = require("../../helpers/build-react-transformer")({
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   post(state, file) {
     state.callee = file.get("jsxIdentifier");
   }
 });
 
-/**
- * [Please add a description.]
- */
-
 visitor.Program = function (node, parent, scope, file) {
   var id = file.opts.jsxPragma;
 
diff --git a/packages/babel-core/src/transformation/transformers/other/regenerator.js b/packages/babel-core/src/transformation/transformers/other/regenerator.js
index ad16230c99..91f91dffb8 100644
--- a/packages/babel-core/src/transformation/transformers/other/regenerator.js
+++ b/packages/babel-core/src/transformation/transformers/other/regenerator.js
@@ -11,16 +11,7 @@ export var metadata = {
   group: "builtin-advanced"
 };
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Function: {
     exit(node) {
       if (node.async || node.generator) {
diff --git a/packages/babel-core/src/transformation/transformers/other/strict.js b/packages/babel-core/src/transformation/transformers/other/strict.js
index ecc5d4094d..e121b87980 100644
--- a/packages/babel-core/src/transformation/transformers/other/strict.js
+++ b/packages/babel-core/src/transformation/transformers/other/strict.js
@@ -16,16 +16,7 @@ function isUseStrict(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   Program: {
     enter(program) {
       var first = program.body[0];
@@ -45,10 +36,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ThisExpression() {
     if (!this.findParent((path) => !path.is("shadow") && THIS_BREAK_KEYS.indexOf(path.type) >= 0)) {
       return t.identifier("undefined");
diff --git a/packages/babel-core/src/transformation/transformers/spec/block-scoped-functions.js b/packages/babel-core/src/transformation/transformers/spec/block-scoped-functions.js
index 9df667e213..3f65ed0197 100644
--- a/packages/babel-core/src/transformation/transformers/spec/block-scoped-functions.js
+++ b/packages/babel-core/src/transformation/transformers/spec/block-scoped-functions.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 function statementList(key, path) {
   var paths = path.get(key);
 
@@ -27,16 +23,7 @@ function statementList(key, path) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   BlockStatement(node, parent) {
     if ((t.isFunction(parent) && parent.body === node) || t.isExportDeclaration(parent)) {
       return;
@@ -45,10 +32,6 @@ export var visitor = {
     statementList("body", this);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   SwitchCase() {
     statementList("consequent", this);
   }
diff --git a/packages/babel-core/src/transformation/transformers/spec/function-name.js b/packages/babel-core/src/transformation/transformers/spec/function-name.js
index 423fe7c4eb..5b6784c0b2 100644
--- a/packages/babel-core/src/transformation/transformers/spec/function-name.js
+++ b/packages/babel-core/src/transformation/transformers/spec/function-name.js
@@ -6,16 +6,7 @@ export var metadata = {
 
 // visit Property functions first - https://github.com/babel/babel/issues/1860
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   "ArrowFunctionExpression|FunctionExpression": {
     exit() {
       if (!this.parentPath.isProperty()) {
@@ -24,10 +15,6 @@ export var visitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ObjectExpression() {
     var props = this.get("properties");
     for (var prop of (props: Array)) {
diff --git a/packages/babel-core/src/transformation/transformers/validation/react.js b/packages/babel-core/src/transformation/transformers/validation/react.js
index 3e8660ae50..fa2103db7a 100644
--- a/packages/babel-core/src/transformation/transformers/validation/react.js
+++ b/packages/babel-core/src/transformation/transformers/validation/react.js
@@ -13,26 +13,13 @@ function check(source, file) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export var visitor = {
-
-  /**
-   * [Please add a description.]
-   */
-
   CallExpression(node, parent, scope, file) {
     if (this.get("callee").isIdentifier({ name: "require" }) && node.arguments.length === 1) {
       check(node.arguments[0], file);
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ModuleDeclaration(node, parent, scope, file) {
     check(node.source, file);
   }
diff --git a/packages/babel-core/src/util.js b/packages/babel-core/src/util.js
index 94cfc0dff8..b2e3adb0be 100644
--- a/packages/babel-core/src/util.js
+++ b/packages/babel-core/src/util.js
@@ -143,7 +143,6 @@ function _shouldIgnore(pattern, filename) {
  */
 
 var templateVisitor = {
-
   /**
    * 360 NoScope PWNd
    */
diff --git a/packages/babel-generator/README.md b/packages/babel-generator/README.md
new file mode 100644
index 0000000000..a71b28d699
--- /dev/null
+++ b/packages/babel-generator/README.md
@@ -0,0 +1 @@
+# babel-generator
diff --git a/packages/babel-generator/src/README.md b/packages/babel-generator/src/README.md
deleted file mode 100644
index 65b83452a5..0000000000
--- a/packages/babel-generator/src/README.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## Generation
-
-Here is Babel's code generator, here you'll find all of the code to turn an AST
-back into a string of code.
-
-[TBD: To Be Documented:]
-
-- Code Generator
-- Buffer
-- Source Maps
-  - Position
-- Printer
-- Code Style
-  - Whitespace
-  - Parenthesis
-- Generators
diff --git a/packages/babel-generator/src/buffer.js b/packages/babel-generator/src/buffer.js
index 0262bb5d77..1dc67227d9 100644
--- a/packages/babel-generator/src/buffer.js
+++ b/packages/babel-generator/src/buffer.js
@@ -160,7 +160,7 @@ export default class Buffer {
    */
 
   newline(i, removeLast) {
-    if (this.format.compact || this.format.retainLines) return;
+    if (this.format.retainLines || this.format.compact) return;
 
     if (this.format.concise) {
       this.space();
diff --git a/packages/babel-generator/src/generators/README.md b/packages/babel-generator/src/generators/README.md
deleted file mode 100644
index 787ebf90bf..0000000000
--- a/packages/babel-generator/src/generators/README.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## Generators
-
-Code generation in Babel is broken down into generators by node type, they all
-live in this directory.
-
-[TBD: To Be Documented:]
-
-- How generators work
-- How to print a node
-- How generators related to one another
diff --git a/packages/babel-generator/src/generators/base.js b/packages/babel-generator/src/generators/base.js
index 8c20a10e04..344a9880f4 100644
--- a/packages/babel-generator/src/generators/base.js
+++ b/packages/babel-generator/src/generators/base.js
@@ -1,23 +1,11 @@
-/**
- * Print File.program
- */
-
 export function File(node, print) {
   print.plain(node.program);
 }
 
-/**
- * Print all nodes in a Program.body.
- */
-
 export function Program(node, print) {
   print.sequence(node.body);
 }
 
-/**
- * Print BlockStatement, collapses empty blocks, prints body.
- */
-
 export function BlockStatement(node, print) {
   this.push("{");
   if (node.body.length) {
@@ -31,13 +19,4 @@ export function BlockStatement(node, print) {
   }
 }
 
-/**
- * What is my purpose?
- * Why am I here?
- * Why are any of us here?
- * Does any of this really matter?
- */
-
-export function Noop() {
-
-}
+export function Noop() {}
diff --git a/packages/babel-generator/src/generators/classes.js b/packages/babel-generator/src/generators/classes.js
index ee52efb6e4..769f43a80f 100644
--- a/packages/babel-generator/src/generators/classes.js
+++ b/packages/babel-generator/src/generators/classes.js
@@ -1,7 +1,3 @@
-/**
- * Print ClassDeclaration, prints decorators, typeParameters, extends, implements, and body.
- */
-
 export function ClassDeclaration(node, print) {
   print.list(node.decorators, { separator: "" });
   this.push("class");
@@ -28,16 +24,8 @@ export function ClassDeclaration(node, print) {
   print.plain(node.body);
 }
 
-/**
- * Alias ClassDeclaration printer as ClassExpression.
- */
-
 export { ClassDeclaration as ClassExpression };
 
-/**
- * Print ClassBody, collapses empty blocks, prints body.
- */
-
 export function ClassBody(node, print) {
   this.push("{");
   if (node.body.length === 0) {
@@ -54,11 +42,6 @@ export function ClassBody(node, print) {
   }
 }
 
-/**
- * Print ClassProperty, prints decorators, static, key, typeAnnotation, and value.
- * Also: semicolons, deal with it.
- */
-
 export function ClassProperty(node, print) {
   print.list(node.decorators, { separator: "" });
 
@@ -74,10 +57,6 @@ export function ClassProperty(node, print) {
   this.semicolon();
 }
 
-/**
- * Print MethodDefinition, prints decorations, static, and method.
- */
-
 export function MethodDefinition(node, print) {
   print.list(node.decorators, { separator: "" });
 
diff --git a/packages/babel-generator/src/generators/comprehensions.js b/packages/babel-generator/src/generators/comprehensions.js
index 1f3ddd8cd2..29b7029cb1 100644
--- a/packages/babel-generator/src/generators/comprehensions.js
+++ b/packages/babel-generator/src/generators/comprehensions.js
@@ -1,7 +1,3 @@
-/**
- * Prints ComprehensionBlock, prints left and right.
- */
-
 export function ComprehensionBlock(node, print) {
   this.keyword("for");
   this.push("(");
@@ -11,10 +7,6 @@ export function ComprehensionBlock(node, print) {
   this.push(")");
 }
 
-/**
- * Prints ComprehensionExpression, prints blocks, filter, and body. Handles generators.
- */
-
 export function ComprehensionExpression(node, print) {
   this.push(node.generator ? "(" : "[");
 
diff --git a/packages/babel-generator/src/generators/expressions.js b/packages/babel-generator/src/generators/expressions.js
index 856b83f461..d1ec81fd54 100644
--- a/packages/babel-generator/src/generators/expressions.js
+++ b/packages/babel-generator/src/generators/expressions.js
@@ -2,16 +2,8 @@ import isInteger from "is-integer";
 import isNumber from "lodash/lang/isNumber";
 import * as t from "babel-types";
 
-/**
- * RegExp for testing scientific notation in literals.
- */
-
 const SCIENTIFIC_NOTATION = /e/i;
 
-/**
- * Prints UnaryExpression, prints operator and argument.
- */
-
 export function UnaryExpression(node, print) {
   var needsSpace = /[a-z]$/.test(node.operator);
   var arg = node.argument;
@@ -29,30 +21,18 @@ export function UnaryExpression(node, print) {
   print.plain(node.argument);
 }
 
-/**
- * Prints DoExpression, prints body.
- */
-
 export function DoExpression(node, print) {
   this.push("do");
   this.space();
   print.plain(node.body);
 }
 
-/**
- * Prints ParenthesizedExpression, prints expression.
- */
-
 export function ParenthesizedExpression(node, print) {
   this.push("(");
   print.plain(node.expression);
   this.push(")");
 }
 
-/**
- * Prints UpdateExpression, prints operator and argument.
- */
-
 export function UpdateExpression(node, print) {
   if (node.prefix) {
     this.push(node.operator);
@@ -63,10 +43,6 @@ export function UpdateExpression(node, print) {
   }
 }
 
-/**
- * Prints ConditionalExpression, prints test, consequent, and alternate.
- */
-
 export function ConditionalExpression(node, print) {
   print.plain(node.test);
   this.space();
@@ -79,10 +55,6 @@ export function ConditionalExpression(node, print) {
   print.plain(node.alternate);
 }
 
-/**
- * Prints NewExpression, prints callee and arguments.
- */
-
 export function NewExpression(node, print) {
   this.push("new ");
   print.plain(node.callee);
@@ -91,44 +63,24 @@ export function NewExpression(node, print) {
   this.push(")");
 }
 
-/**
- * Prints SequenceExpression.expressions.
- */
-
 export function SequenceExpression(node, print) {
   print.list(node.expressions);
 }
 
-/**
- * Prints ThisExpression.
- */
-
 export function ThisExpression() {
   this.push("this");
 }
 
-/**
- * Prints Super.
- */
-
 export function Super() {
   this.push("super");
 }
 
-/**
- * Prints Decorator, prints expression.
- */
-
 export function Decorator(node, print) {
   this.push("@");
   print.plain(node.expression);
   this.newline();
 }
 
-/**
- * Prints CallExpression, prints callee and arguments.
- */
-
 export function CallExpression(node, print) {
   print.plain(node.callee);
 
@@ -153,12 +105,7 @@ export function CallExpression(node, print) {
   this.push(")");
 }
 
-/**
- * Builds yield or await expression printer.
- * Prints delegate, all, and argument.
- */
-
-var buildYieldAwait = function (keyword) {
+function buildYieldAwait(keyword) {
   return function (node, print) {
     this.push(keyword);
 
@@ -173,46 +120,26 @@ var buildYieldAwait = function (keyword) {
       this.endTerminatorless(terminatorState);
     }
   };
-};
-
-/**
- * Create YieldExpression and AwaitExpression printers.
- */
+}
 
 export var YieldExpression = buildYieldAwait("yield");
 export var AwaitExpression = buildYieldAwait("await");
 
-/**
- * Prints EmptyStatement.
- */
-
 export function EmptyStatement() {
   this.semicolon();
 }
 
-/**
- * Prints ExpressionStatement, prints expression.
- */
-
 export function ExpressionStatement(node, print) {
   print.plain(node.expression);
   this.semicolon();
 }
 
-/**
- * Prints AssignmentPattern, prints left and right.
- */
-
 export function AssignmentPattern(node, print) {
   print.plain(node.left);
   this.push(" = ");
   print.plain(node.right);
 }
 
-/**
- * Prints AssignmentExpression, prints left, operator, and right.
- */
-
 export function AssignmentExpression(node, print) {
   // todo: add cases where the spaces can be dropped when in compact mode
   print.plain(node.left);
@@ -236,30 +163,17 @@ export function AssignmentExpression(node, print) {
   print.plain(node.right);
 }
 
-/**
- * Prints BindExpression, prints object and callee.
- */
-
 export function BindExpression(node, print) {
   print.plain(node.object);
   this.push("::");
   print.plain(node.callee);
 }
 
-/**
- * Alias ClassDeclaration printer as ClassExpression,
- * and AssignmentExpression printer as LogicalExpression.
- */
-
 export {
   AssignmentExpression as BinaryExpression,
   AssignmentExpression as LogicalExpression
 };
 
-/**
- * Print MemberExpression, prints object, property, and value. Handles computed.
- */
-
 export function MemberExpression(node, print) {
   var obj = node.object;
   print.plain(obj);
@@ -290,10 +204,6 @@ export function MemberExpression(node, print) {
   }
 }
 
-/**
- * Print MetaProperty, prints meta and property.
- */
-
 export function MetaProperty(node, print) {
   print.plain(node.meta);
   this.push(".");
diff --git a/packages/babel-generator/src/generators/flow.js b/packages/babel-generator/src/generators/flow.js
index 7fed8141d6..8e0e0cf832 100644
--- a/packages/babel-generator/src/generators/flow.js
+++ b/packages/babel-generator/src/generators/flow.js
@@ -1,52 +1,28 @@
 import * as t from "babel-types";
 
-/**
- * Prints AnyTypeAnnotation.
- */
-
 export function AnyTypeAnnotation() {
   this.push("any");
 }
 
-/**
- * Prints ArrayTypeAnnotation, prints elementType.
- */
-
 export function ArrayTypeAnnotation(node, print) {
   print.plain(node.elementType);
   this.push("[");
   this.push("]");
 }
 
-/**
- * Prints BooleanTypeAnnotation.
- */
-
 export function BooleanTypeAnnotation() {
   this.push("bool");
 }
 
-/**
- * Prints BooleanLiteralTypeAnnotation.
- */
-
 export function BooleanLiteralTypeAnnotation(node) {
   this.push(node.value ? "true" : "false");
 }
 
-/**
- * Prints DeclareClass, prints node.
- */
-
 export function DeclareClass(node, print) {
   this.push("declare class ");
   this._interfaceish(node, print);
 }
 
-/**
- * Prints DeclareFunction, prints id and id.typeAnnotation.
- */
-
 export function DeclareFunction(node, print) {
   this.push("declare function ");
   print.plain(node.id);
@@ -54,10 +30,6 @@ export function DeclareFunction(node, print) {
   this.semicolon();
 }
 
-/**
- * Prints DeclareModule, prints id and body.
- */
-
 export function DeclareModule(node, print) {
   this.push("declare module ");
   print.plain(node.id);
@@ -65,10 +37,6 @@ export function DeclareModule(node, print) {
   print.plain(node.body);
 }
 
-/**
- * Prints DeclareVariable, prints id and id.typeAnnotation.
- */
-
 export function DeclareVariable(node, print) {
   this.push("declare var ");
   print.plain(node.id);
@@ -76,10 +44,6 @@ export function DeclareVariable(node, print) {
   this.semicolon();
 }
 
-/**
- * Prints FunctionTypeAnnotation, prints typeParameters, params, and rest.
- */
-
 export function FunctionTypeAnnotation(node, print, parent) {
   print.plain(node.typeParameters);
   this.push("(");
@@ -108,10 +72,6 @@ export function FunctionTypeAnnotation(node, print, parent) {
   print.plain(node.returnType);
 }
 
-/**
- * Prints FunctionTypeParam, prints name and typeAnnotation, handles optional.
- */
-
 export function FunctionTypeParam(node, print) {
   print.plain(node.name);
   if (node.optional) this.push("?");
@@ -120,26 +80,13 @@ export function FunctionTypeParam(node, print) {
   print.plain(node.typeAnnotation);
 }
 
-/**
- * Prints InterfaceExtends, prints id and typeParameters.
- */
-
 export function InterfaceExtends(node, print) {
   print.plain(node.id);
   print.plain(node.typeParameters);
 }
 
-/**
- * Alias InterfaceExtends printer as ClassImplements,
- * and InterfaceExtends printer as GenericTypeAnnotation.
- */
-
 export { InterfaceExtends as ClassImplements, InterfaceExtends as GenericTypeAnnotation };
 
-/**
- * Prints interface-like node, prints id, typeParameters, extends, and body.
- */
-
 export function _interfaceish(node, print) {
   print.plain(node.id);
   print.plain(node.typeParameters);
@@ -151,93 +98,49 @@ export function _interfaceish(node, print) {
   print.plain(node.body);
 }
 
-/**
- * Prints InterfaceDeclaration, prints node.
- */
-
 export function InterfaceDeclaration(node, print) {
   this.push("interface ");
   this._interfaceish(node, print);
 }
 
-/**
- * Prints IntersectionTypeAnnotation, prints types.
- */
-
 export function IntersectionTypeAnnotation(node, print) {
   print.join(node.types, { separator: " & " });
 }
 
-/**
- * Prints MixedTypeAnnotation.
- */
-
 export function MixedTypeAnnotation() {
   this.push("mixed");
 }
 
-/**
- * Prints NullableTypeAnnotation, prints typeAnnotation.
- */
-
 export function NullableTypeAnnotation(node, print) {
   this.push("?");
   print.plain(node.typeAnnotation);
 }
 
-/**
- * Prints NumberLiteralTypeAnnotation, prints value.
- */
-
 export { Literal as NumberLiteralTypeAnnotation } from "./types";
 
-/**
- * Prints NumberTypeAnnotation.
- */
-
 export function NumberTypeAnnotation() {
   this.push("number");
 }
 
-/**
- * Prints StringLiteralTypeAnnotation, prints value.
- */
-
 export function StringLiteralTypeAnnotation(node) {
   this.push(this._stringLiteral(node.value));
 }
 
-/**
- * Prints StringTypeAnnotation.
- */
-
 export function StringTypeAnnotation() {
   this.push("string");
 }
 
-/**
- * Prints TupleTypeAnnotation, prints types.
- */
-
 export function TupleTypeAnnotation(node, print) {
   this.push("[");
   print.join(node.types, { separator: ", " });
   this.push("]");
 }
 
-/**
- * Prints TypeofTypeAnnotation, prints argument.
- */
-
 export function TypeofTypeAnnotation(node, print) {
   this.push("typeof ");
   print.plain(node.argument);
 }
 
-/**
- * Prints TypeAlias, prints id, typeParameters, and right.
- */
-
 export function TypeAlias(node, print) {
   this.push("type ");
   print.plain(node.id);
@@ -249,10 +152,6 @@ export function TypeAlias(node, print) {
   this.semicolon();
 }
 
-/**
- * Prints TypeAnnotation, prints typeAnnotation, handles optional.
- */
-
 export function TypeAnnotation(node, print) {
   this.push(":");
   this.space();
@@ -260,10 +159,6 @@ export function TypeAnnotation(node, print) {
   print.plain(node.typeAnnotation);
 }
 
-/**
- * Prints TypeParameterInstantiation, prints params.
- */
-
 export function TypeParameterInstantiation(node, print) {
   this.push("<");
   print.join(node.params, {
@@ -275,16 +170,8 @@ export function TypeParameterInstantiation(node, print) {
   this.push(">");
 }
 
-/**
- * Alias TypeParameterInstantiation printer as TypeParameterDeclaration
- */
-
 export { TypeParameterInstantiation as TypeParameterDeclaration };
 
-/**
- * Prints ObjectTypeAnnotation, prints properties, callProperties, and indexers.
- */
-
 export function ObjectTypeAnnotation(node, print) {
   this.push("{");
   var props = node.properties.concat(node.callProperties, node.indexers);
@@ -309,19 +196,11 @@ export function ObjectTypeAnnotation(node, print) {
   this.push("}");
 }
 
-/**
- * Prints ObjectTypeCallProperty, prints value, handles static.
- */
-
 export function ObjectTypeCallProperty(node, print) {
   if (node.static) this.push("static ");
   print.plain(node.value);
 }
 
-/**
- * Prints ObjectTypeIndexer, prints id, key, and value, handles static.
- */
-
 export function ObjectTypeIndexer(node, print) {
   if (node.static) this.push("static ");
   this.push("[");
@@ -335,10 +214,6 @@ export function ObjectTypeIndexer(node, print) {
   print.plain(node.value);
 }
 
-/**
- * Prints ObjectTypeProperty, prints static, key, and value.
- */
-
 export function ObjectTypeProperty(node, print) {
   if (node.static) this.push("static ");
   print.plain(node.key);
@@ -350,28 +225,16 @@ export function ObjectTypeProperty(node, print) {
   print.plain(node.value);
 }
 
-/**
- * Prints QualifiedTypeIdentifier, prints qualification and id.
- */
-
 export function QualifiedTypeIdentifier(node, print) {
   print.plain(node.qualification);
   this.push(".");
   print.plain(node.id);
 }
 
-/**
- * Prints UnionTypeAnnotation, prints types.
- */
-
 export function UnionTypeAnnotation(node, print) {
   print.join(node.types, { separator: " | " });
 }
 
-/**
- * Prints TypeCastExpression, prints expression and typeAnnotation.
- */
-
 export function TypeCastExpression(node, print) {
   this.push("(");
   print.plain(node.expression);
@@ -379,10 +242,6 @@ export function TypeCastExpression(node, print) {
   this.push(")");
 }
 
-/**
- * Prints VoidTypeAnnotation.
- */
-
 export function VoidTypeAnnotation() {
   this.push("void");
 }
diff --git a/packages/babel-generator/src/generators/jsx.js b/packages/babel-generator/src/generators/jsx.js
index b2a8095f05..b187930a69 100644
--- a/packages/babel-generator/src/generators/jsx.js
+++ b/packages/babel-generator/src/generators/jsx.js
@@ -1,9 +1,3 @@
-import * as t from "babel-types";
-
-/**
- * Prints JSXAttribute, prints name and value.
- */
-
 export function JSXAttribute(node, print) {
   print.plain(node.name);
   if (node.value) {
@@ -12,57 +6,37 @@ export function JSXAttribute(node, print) {
   }
 }
 
-/**
- * Prints JSXIdentifier, prints name.
- */
-
 export function JSXIdentifier(node) {
   this.push(node.name);
 }
 
-/**
- * Prints JSXNamespacedName, prints namespace and name.
- */
-
 export function JSXNamespacedName(node, print) {
   print.plain(node.namespace);
   this.push(":");
   print.plain(node.name);
 }
 
-/**
- * Prints JSXMemberExpression, prints object and property.
- */
-
 export function JSXMemberExpression(node, print) {
   print.plain(node.object);
   this.push(".");
   print.plain(node.property);
 }
 
-/**
- * Prints JSXSpreadAttribute, prints argument.
- */
-
 export function JSXSpreadAttribute(node, print) {
   this.push("{...");
   print.plain(node.argument);
   this.push("}");
 }
 
-/**
- * Prints JSXExpressionContainer, prints expression.
- */
-
 export function JSXExpressionContainer(node, print) {
   this.push("{");
   print.plain(node.expression);
   this.push("}");
 }
 
-/**
- * Prints JSXElement, prints openingElement, children, and closingElement.
- */
+export function JSXText(node) {
+  this.push(node.value, true);
+}
 
 export function JSXElement(node, print) {
   var open = node.openingElement;
@@ -71,21 +45,13 @@ export function JSXElement(node, print) {
 
   this.indent();
   for (var child of (node.children: Array)) {
-    if (t.isLiteral(child)) {
-      this.push(child.value, true);
-    } else {
-      print.plain(child);
-    }
+    print.plain(child);
   }
   this.dedent();
 
   print.plain(node.closingElement);
 }
 
-/**
- * Prints JSXOpeningElement, prints name and attributes, handles selfClosing.
- */
-
 export function JSXOpeningElement(node, print) {
   this.push("<");
   print.plain(node.name);
@@ -96,18 +62,10 @@ export function JSXOpeningElement(node, print) {
   this.push(node.selfClosing ? " />" : ">");
 }
 
-/**
- * Prints JSXClosingElement, prints name.
- */
-
 export function JSXClosingElement(node, print) {
   this.push("</");
   print.plain(node.name);
   this.push(">");
 }
 
-/**
- * Prints JSXEmptyExpression.
- */
-
 export function JSXEmptyExpression() {}
diff --git a/packages/babel-generator/src/generators/methods.js b/packages/babel-generator/src/generators/methods.js
index 6796414879..68f86f67dd 100644
--- a/packages/babel-generator/src/generators/methods.js
+++ b/packages/babel-generator/src/generators/methods.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * Prints nodes with params, prints typeParameters, params, and returnType, handles optional params.
- */
-
 export function _params(node, print) {
   print.plain(node.typeParameters);
   this.push("(");
@@ -20,10 +16,6 @@ export function _params(node, print) {
   }
 }
 
-/**
- * Prints method-like nodes, prints key, value, and body, handles async, generator, computed, and get or set.
- */
-
 export function _method(node, print) {
   var value = node.value;
   var kind  = node.kind;
@@ -54,10 +46,6 @@ export function _method(node, print) {
   print.plain(value.body);
 }
 
-/**
- * Prints FunctionExpression, prints id and body, handles async and generator.
- */
-
 export function FunctionExpression(node, print) {
   if (node.async) this.push("async ");
   this.push("function");
@@ -75,17 +63,8 @@ export function FunctionExpression(node, print) {
   print.plain(node.body);
 }
 
-/**
- * Alias FunctionExpression printer as FunctionDeclaration.
- */
-
 export { FunctionExpression as FunctionDeclaration };
 
-/**
- * Prints ArrowFunctionExpression, prints params and body, handles async.
- * Leaves out parentheses when single param.
- */
-
 export function ArrowFunctionExpression(node, print) {
   if (node.async) this.push("async ");
 
diff --git a/packages/babel-generator/src/generators/modules.js b/packages/babel-generator/src/generators/modules.js
index 74659136ce..951e6bb24b 100644
--- a/packages/babel-generator/src/generators/modules.js
+++ b/packages/babel-generator/src/generators/modules.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * Prints ImportSpecifier, prints imported and local.
- */
-
 export function ImportSpecifier(node, print) {
   print.plain(node.imported);
   if (node.local && node.local.name !== node.imported.name) {
@@ -12,26 +8,14 @@ export function ImportSpecifier(node, print) {
   }
 }
 
-/**
- * Prints ImportDefaultSpecifier, prints local.
- */
-
 export function ImportDefaultSpecifier(node, print) {
   print.plain(node.local);
 }
 
-/**
- * Prints ExportDefaultSpecifier, prints exported.
- */
-
 export function ExportDefaultSpecifier(node, print) {
   print.plain(node.exported);
 }
 
-/**
- * Prints ExportSpecifier, prints local and exported.
- */
-
 export function ExportSpecifier(node, print) {
   print.plain(node.local);
   if (node.exported && node.local.name !== node.exported.name) {
@@ -40,19 +24,11 @@ export function ExportSpecifier(node, print) {
   }
 }
 
-/**
- * Prints ExportNamespaceSpecifier, prints exported.
- */
-
 export function ExportNamespaceSpecifier(node, print) {
   this.push("* as ");
   print.plain(node.exported);
 }
 
-/**
- * Prints ExportAllDeclaration, prints exported and source.
- */
-
 export function ExportAllDeclaration(node, print) {
   this.push("export *");
   if (node.exported) {
@@ -64,28 +40,16 @@ export function ExportAllDeclaration(node, print) {
   this.semicolon();
 }
 
-/**
- * Prints ExportNamedDeclaration, delegates to ExportDeclaration.
- */
-
 export function ExportNamedDeclaration(node, print) {
   this.push("export ");
   ExportDeclaration.call(this, node, print);
 }
 
-/**
- * Prints ExportDefaultDeclaration, delegates to ExportDeclaration.
- */
-
 export function ExportDefaultDeclaration(node, print) {
   this.push("export default ");
   ExportDeclaration.call(this, node, print);
 }
 
-/**
- * Prints ExportDeclaration, prints specifiers, declration, and source.
- */
-
 function ExportDeclaration(node, print) {
   var specifiers = node.specifiers;
 
@@ -127,10 +91,6 @@ function ExportDeclaration(node, print) {
   this.ensureSemicolon();
 }
 
-/**
- * Prints ImportDeclaration, prints specifiers and source, handles isType.
- */
-
 export function ImportDeclaration(node, print) {
   this.push("import ");
 
@@ -163,10 +123,6 @@ export function ImportDeclaration(node, print) {
   this.semicolon();
 }
 
-/**
- * Prints ImportNamespaceSpecifier, prints local.
- */
-
 export function ImportNamespaceSpecifier(node, print) {
   this.push("* as ");
   print.plain(node.local);
diff --git a/packages/babel-generator/src/generators/statements.js b/packages/babel-generator/src/generators/statements.js
index 8663839896..d059ead64d 100644
--- a/packages/babel-generator/src/generators/statements.js
+++ b/packages/babel-generator/src/generators/statements.js
@@ -1,10 +1,6 @@
 import repeating from "repeating";
 import * as t from "babel-types";
 
-/**
- * Prints WithStatement, prints object and body.
- */
-
 export function WithStatement(node, print) {
   this.keyword("with");
   this.push("(");
@@ -13,10 +9,6 @@ export function WithStatement(node, print) {
   print.block(node.body);
 }
 
-/**
- * Prints IfStatement, prints test, consequent, and alternate.
- */
-
 export function IfStatement(node, print) {
   this.keyword("if");
   this.push("(");
@@ -33,10 +25,6 @@ export function IfStatement(node, print) {
   }
 }
 
-/**
- * Prints ForStatement, prints init, test, update, and body.
- */
-
 export function ForStatement(node, print) {
   this.keyword("for");
   this.push("(");
@@ -59,10 +47,6 @@ export function ForStatement(node, print) {
   print.block(node.body);
 }
 
-/**
- * Prints WhileStatement, prints test and body.
- */
-
 export function WhileStatement(node, print) {
   this.keyword("while");
   this.push("(");
@@ -71,11 +55,6 @@ export function WhileStatement(node, print) {
   print.block(node.body);
 }
 
-/**
- * Builds ForIn or ForOf statement printers.
- * Prints left, right, and body.
- */
-
 var buildForXStatement = function (op) {
   return function (node, print) {
     this.keyword("for");
@@ -88,17 +67,9 @@ var buildForXStatement = function (op) {
   };
 };
 
-/**
- * Create ForInStatement and ForOfStatement printers.
- */
-
 export var ForInStatement = buildForXStatement("in");
 export var ForOfStatement = buildForXStatement("of");
 
-/**
- * Prints DoWhileStatement, prints body and test.
- */
-
 export function DoWhileStatement(node, print) {
   this.push("do ");
   print.plain(node.body);
@@ -109,12 +80,7 @@ export function DoWhileStatement(node, print) {
   this.push(");");
 }
 
-/**
- * Builds continue, return, or break statement printers.
- * Prints label (or key).
- */
-
-var buildLabelStatement = function (prefix, key = "label") {
+function buildLabelStatement(prefix, key = "label") {
   return function (node, print) {
     this.push(prefix);
 
@@ -128,31 +94,19 @@ var buildLabelStatement = function (prefix, key = "label") {
 
     this.semicolon();
   };
-};
-
-/**
- * Create ContinueStatement, ReturnStatement, and BreakStatement printers.
- */
+}
 
 export var ContinueStatement = buildLabelStatement("continue");
 export var ReturnStatement   = buildLabelStatement("return", "argument");
 export var BreakStatement    = buildLabelStatement("break");
 export var ThrowStatement    = buildLabelStatement("throw", "argument");
 
-/**
- * Prints LabeledStatement, prints label and body.
- */
-
 export function LabeledStatement(node, print) {
   print.plain(node.label);
   this.push(": ");
   print.plain(node.body);
 }
 
-/**
- * Prints TryStatement, prints block, handlers, and finalizer.
- */
-
 export function TryStatement(node, print) {
   this.keyword("try");
   print.plain(node.block);
@@ -174,10 +128,6 @@ export function TryStatement(node, print) {
   }
 }
 
-/**
- * Prints CatchClause, prints param and body.
- */
-
 export function CatchClause(node, print) {
   this.keyword("catch");
   this.push("(");
@@ -186,10 +136,6 @@ export function CatchClause(node, print) {
   print.plain(node.body);
 }
 
-/**
- * Prints SwitchStatement, prints discriminant and cases.
- */
-
 export function SwitchStatement(node, print) {
   this.keyword("switch");
   this.push("(");
@@ -208,10 +154,6 @@ export function SwitchStatement(node, print) {
   this.push("}");
 }
 
-/**
- * Prints SwitchCase, prints test and consequent.
- */
-
 export function SwitchCase(node, print) {
   if (node.test) {
     this.push("case ");
@@ -227,18 +169,10 @@ export function SwitchCase(node, print) {
   }
 }
 
-/**
- * Prints DebuggerStatement.
- */
-
 export function DebuggerStatement() {
   this.push("debugger;");
 }
 
-/**
- * Prints VariableDeclaration, prints declarations, handles kind and format.
- */
-
 export function VariableDeclaration(node, print, parent) {
   this.push(node.kind + " ");
 
@@ -282,10 +216,6 @@ export function VariableDeclaration(node, print, parent) {
   this.semicolon();
 }
 
-/**
- * Prints VariableDeclarator, handles id, id.typeAnnotation, and init.
- */
-
 export function VariableDeclarator(node, print) {
   print.plain(node.id);
   print.plain(node.id.typeAnnotation);
diff --git a/packages/babel-generator/src/generators/template-literals.js b/packages/babel-generator/src/generators/template-literals.js
index 50174a581a..1bd78796dd 100644
--- a/packages/babel-generator/src/generators/template-literals.js
+++ b/packages/babel-generator/src/generators/template-literals.js
@@ -1,24 +1,12 @@
-/**
- * Prints TaggedTemplateExpression, prints tag and quasi.
- */
-
 export function TaggedTemplateExpression(node, print) {
   print.plain(node.tag);
   print.plain(node.quasi);
 }
 
-/**
- * Prints TemplateElement, prints value.
- */
-
 export function TemplateElement(node) {
   this._push(node.value.raw);
 }
 
-/**
- * Prints TemplateLiteral, prints quasis, and expressions.
- */
-
 export function TemplateLiteral(node, print) {
   this.push("`");
 
diff --git a/packages/babel-generator/src/generators/types.js b/packages/babel-generator/src/generators/types.js
index b50334fde2..dc892ab8f0 100644
--- a/packages/babel-generator/src/generators/types.js
+++ b/packages/babel-generator/src/generators/types.js
@@ -2,34 +2,17 @@
 
 import * as t from "babel-types";
 
-/**
- * Prints Identifier, prints name.
- */
-
 export function Identifier(node) {
   this.push(node.name);
 }
 
-/**
- * Prints RestElement, prints argument.
- */
-
 export function RestElement(node, print) {
   this.push("...");
   print.plain(node.argument);
 }
 
-/**
- * Alias RestElement printer as SpreadElement,
- * and RestElement printer as SpreadProperty.
- */
-
 export { RestElement as SpreadElement, RestElement as SpreadProperty };
 
-/**
- * Prints ObjectExpression, prints properties.
- */
-
 export function ObjectExpression(node, print) {
   var props = node.properties;
 
@@ -45,16 +28,8 @@ export function ObjectExpression(node, print) {
   this.push("}");
 }
 
-/**
- * Alias ObjectExpression printer as ObjectPattern.
- */
-
 export { ObjectExpression as ObjectPattern };
 
-/**
- * Prints Property, prints decorators, key, and value, handles kind, computed, and shorthand.
- */
-
 export function Property(node, print) {
   print.list(node.decorators, { separator: "" });
 
@@ -89,10 +64,6 @@ export function Property(node, print) {
   }
 }
 
-/**
- * Prints ArrayExpression, prints elements.
- */
-
 export function ArrayExpression(node, print) {
   var elems = node.elements;
   var len   = elems.length;
@@ -119,10 +90,6 @@ export function ArrayExpression(node, print) {
   this.push("]");
 }
 
-/**
- * Alias ArrayExpression printer as ArrayPattern.
- */
-
 export { ArrayExpression as ArrayPattern };
 
 export function RegexLiteral(node) {
diff --git a/packages/babel-generator/src/index.js b/packages/babel-generator/src/index.js
index e72d2eacdb..6a7b60e748 100644
--- a/packages/babel-generator/src/index.js
+++ b/packages/babel-generator/src/index.js
@@ -157,10 +157,6 @@ class CodeGenerator {
     return new NodePrinter(this, parent);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   catchUp(node) {
     // catch up to this nodes newline if we're behind
     if (node.loc && this.format.retainLines && this.buffer.buf) {
@@ -170,10 +166,6 @@ class CodeGenerator {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _printNewline(leading, node, parent, opts) {
     if (!opts.statement && !n.isUserWhitespacable(node, parent)) {
       return;
@@ -204,10 +196,6 @@ class CodeGenerator {
     this.newline(lines);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   print(node, parent, opts = {}) {
     if (!node) return;
 
@@ -250,10 +238,6 @@ class CodeGenerator {
     this.printTrailingComments(node, parent);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   printJoin(print, nodes, opts = {}) {
     if (!nodes || !nodes.length) return;
 
@@ -283,10 +267,6 @@ class CodeGenerator {
     if (opts.indent) this.dedent();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   printAndIndentOnComments(print, node) {
     var indent = !!node.leadingComments;
     if (indent) this.indent();
@@ -294,10 +274,6 @@ class CodeGenerator {
     if (indent) this.dedent();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   printBlock(print, node) {
     if (t.isEmptyStatement(node)) {
       this.semicolon();
@@ -307,10 +283,6 @@ class CodeGenerator {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   generateComment(comment) {
     var val = comment.value;
     if (comment.type === "CommentLine") {
@@ -321,26 +293,14 @@ class CodeGenerator {
     return val;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   printTrailingComments(node, parent) {
     this._printComments(this.getComments("trailingComments", node, parent));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   printLeadingComments(node, parent) {
     this._printComments(this.getComments("leadingComments", node, parent));
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getComments(key, node, parent) {
     if (t.isExpressionStatement(parent)) {
       return [];
@@ -360,18 +320,10 @@ class CodeGenerator {
     return comments;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _getComments(key, node) {
     return (node && node[key]) || [];
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   shouldPrintComment(comment) {
     if (this.format.shouldPrintComment) {
       return this.format.shouldPrintComment(comment.value);
@@ -384,10 +336,6 @@ class CodeGenerator {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _printComments(comments) {
     if (!comments || !comments.length) return;
 
@@ -440,28 +388,16 @@ class CodeGenerator {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 each(Buffer.prototype, function (fn, key) {
   CodeGenerator.prototype[key] = function () {
     return fn.apply(this.buffer, arguments);
   };
 });
 
-/**
- * [Please add a description.]
- */
-
 each(CodeGenerator.generators, function (generator) {
   extend(CodeGenerator.prototype, generator);
 });
 
-/**
- * [Please add a description.]
- */
-
 module.exports = function (ast, opts, code) {
   var gen = new CodeGenerator(ast, opts, code);
   return gen.generate();
diff --git a/packages/babel-generator/src/node/parentheses.js b/packages/babel-generator/src/node/parentheses.js
index 60f90e66fc..b511d471f7 100644
--- a/packages/babel-generator/src/node/parentheses.js
+++ b/packages/babel-generator/src/node/parentheses.js
@@ -1,12 +1,6 @@
 import each from "lodash/collection/each";
 import * as t from "babel-types";
 
-/**
- * Create a mapping of operators to precendence.
- *
- * @example
- * { "==": 6, "+": 9 }
- */
 const PRECEDENCE = {};
 
 each([
@@ -27,24 +21,12 @@ each([
   });
 });
 
-/**
- * Test if NullableTypeAnnotation needs parentheses.
- */
-
 export function NullableTypeAnnotation(node, parent) {
   return t.isArrayTypeAnnotation(parent);
 }
 
-/**
- * Alias NullableTypeAnnotation test as FunctionTypeAnnotation.
- */
-
 export { NullableTypeAnnotation as FunctionTypeAnnotation };
 
-/**
- * Test if UpdateExpression needs parentheses.
- */
-
 export function UpdateExpression(node, parent) {
   if (t.isMemberExpression(parent) && parent.object === node) {
     // (foo++).test()
@@ -52,10 +34,6 @@ export function UpdateExpression(node, parent) {
   }
 }
 
-/**
- * Test if ObjectExpression needs parentheses.
- */
-
 export function ObjectExpression(node, parent) {
   if (t.isExpressionStatement(parent)) {
     // ({ foo: "bar" });
@@ -70,10 +48,6 @@ export function ObjectExpression(node, parent) {
   return false;
 }
 
-/**
- * Test if Binary needs parentheses.
- */
-
 export function Binary(node, parent) {
   if ((t.isCallExpression(parent) || t.isNewExpression(parent)) && parent.callee === node) {
     return true;
@@ -104,10 +78,6 @@ export function Binary(node, parent) {
   }
 }
 
-/**
- * Test if BinaryExpression needs parentheses.
- */
-
 export function BinaryExpression(node, parent) {
   if (node.operator === "in") {
     // var i = (1 in []);
@@ -122,10 +92,6 @@ export function BinaryExpression(node, parent) {
   }
 }
 
-/**
- * Test if SequenceExpression needs parentheses.
- */
-
 export function SequenceExpression(node, parent) {
   if (t.isForStatement(parent)) {
     // Although parentheses wouldn't hurt around sequence
@@ -144,10 +110,6 @@ export function SequenceExpression(node, parent) {
   return true;
 }
 
-/**
- * Test if YieldExpression needs parentheses.
- */
-
 export function YieldExpression(node, parent) {
   return t.isBinary(parent) ||
          t.isUnaryLike(parent) ||
@@ -158,26 +120,14 @@ export function YieldExpression(node, parent) {
          t.isYieldExpression(parent);
 }
 
-/**
- * Test if ClassExpression needs parentheses.
- */
-
 export function ClassExpression(node, parent) {
   return t.isExpressionStatement(parent);
 }
 
-/**
- * Test if UnaryLike needs parentheses.
- */
-
 export function UnaryLike(node, parent) {
   return t.isMemberExpression(parent) && parent.object === node;
 }
 
-/**
- * Test if FunctionExpression needs parentheses.
- */
-
 export function FunctionExpression(node, parent) {
   // function () {};
   if (t.isExpressionStatement(parent)) {
@@ -195,10 +145,6 @@ export function FunctionExpression(node, parent) {
   }
 }
 
-/**
- * Test if ConditionalExpression needs parentheses.
- */
-
 export function ConditionalExpression(node, parent) {
   if (t.isUnaryLike(parent)) {
     return true;
@@ -225,10 +171,6 @@ export function ConditionalExpression(node, parent) {
   return false;
 }
 
-/**
- * Test if AssignmentExpression needs parentheses.
- */
-
 export function AssignmentExpression(node) {
   if (t.isObjectPattern(node.left)) {
     return true;
diff --git a/packages/babel-generator/src/node/whitespace.js b/packages/babel-generator/src/node/whitespace.js
index 055b803a93..6511c35949 100644
--- a/packages/babel-generator/src/node/whitespace.js
+++ b/packages/babel-generator/src/node/whitespace.js
@@ -48,10 +48,6 @@ function isHelper(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function isType(node) {
   return t.isLiteral(node) || t.isObjectExpression(node) || t.isArrayExpression(node) ||
          t.isIdentifier(node) || t.isMemberExpression(node);
diff --git a/packages/babel-generator/src/whitespace.js b/packages/babel-generator/src/whitespace.js
index 3718fbfb58..24ff017962 100644
--- a/packages/babel-generator/src/whitespace.js
+++ b/packages/babel-generator/src/whitespace.js
@@ -1,14 +1,9 @@
 /**
  * Returns `i`th number from `base`, continuing from 0 when `max` is reached.
  * Useful for shifting `for` loop by a fixed number but going over all items.
- *
- * @param {Number} i Current index in the loop
- * @param {Number} base Start index for which to return 0
- * @param {Number} max Array length
- * @returns {Number} shiftedIndex
  */
 
-function getLookupIndex(i, base, max) {
+function getLookupIndex(i: number, base: number, max: number): number {
   i += base;
 
   if (i >= max) {
diff --git a/packages/babel-runtime/README.md b/packages/babel-runtime/README.md
index bde5507297..f063c2fdf8 100644
--- a/packages/babel-runtime/README.md
+++ b/packages/babel-runtime/README.md
@@ -1,5 +1 @@
 # babel-runtime
-
-Babel self-contained runtime
-
-For more information please look at [babel](https://github.com/babel/babel).
diff --git a/packages/babel-traverse/README.md b/packages/babel-traverse/README.md
new file mode 100644
index 0000000000..6addc10651
--- /dev/null
+++ b/packages/babel-traverse/README.md
@@ -0,0 +1 @@
+# babel-traverse
diff --git a/packages/babel-traverse/src/README.md b/packages/babel-traverse/src/README.md
deleted file mode 100644
index 69c1a8a4cd..0000000000
--- a/packages/babel-traverse/src/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Traversal
-
-This is the Traversal directory.
diff --git a/packages/babel-traverse/src/context.js b/packages/babel-traverse/src/context.js
index c890060a84..da19dfe646 100644
--- a/packages/babel-traverse/src/context.js
+++ b/packages/babel-traverse/src/context.js
@@ -1,9 +1,5 @@
 import NodePath from "./path";
 import * as t from "babel-types";
-
-/**
- * [Please add a description.]
- */
 export default class TraversalContext {
   constructor(scope, opts, state, parentPath) {
     this.parentPath = parentPath;
@@ -13,10 +9,6 @@ export default class TraversalContext {
   }
 
   queue = null;
-
-  /**
-   * [Please add a description.]
-   */
   shouldVisit(node) {
     var opts = this.opts;
     if (opts.enter || opts.exit) return true;
@@ -32,10 +24,6 @@ export default class TraversalContext {
 
     return false;
   }
-
-  /**
-   * [Please add a description.]
-   */
   create(node, obj, key, listKey) {
     var path = NodePath.get({
       parentPath: this.parentPath,
@@ -47,10 +35,6 @@ export default class TraversalContext {
     path.unshiftContext(this);
     return path;
   }
-
-  /**
-   * [Please add a description.]
-   */
   visitMultiple(container, parent, listKey) {
     // nothing to traverse!
     if (container.length === 0) return false;
@@ -89,10 +73,6 @@ export default class TraversalContext {
 
     return stop;
   }
-
-  /**
-   * [Please add a description.]
-   */
   visitSingle(node, key) {
     if (this.shouldVisit(node[key])) {
       var path = this.create(node, node, key);
@@ -100,10 +80,6 @@ export default class TraversalContext {
       path.shiftContext();
     }
   }
-
-  /**
-   * [Please add a description.]
-   */
   visit(node, key) {
     var nodes = node[key];
     if (!nodes) return;
diff --git a/packages/babel-traverse/src/hub.js b/packages/babel-traverse/src/hub.js
index 4eab4d299b..f1b0fb0243 100644
--- a/packages/babel-traverse/src/hub.js
+++ b/packages/babel-traverse/src/hub.js
@@ -3,7 +3,8 @@
  */
 
 export default class Hub {
-  constructor(file) {
+  constructor(file, options) {
     this.file = file;
+    this.options = options;
   }
 }
diff --git a/packages/babel-traverse/src/index.js b/packages/babel-traverse/src/index.js
index 495212f7f7..117c3a1355 100644
--- a/packages/babel-traverse/src/index.js
+++ b/packages/babel-traverse/src/index.js
@@ -4,10 +4,6 @@ import * as messages from "babel-messages";
 import includes from "lodash/collection/includes";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function traverse(parent: Object, opts?: Object, scope?: Object, state: Object, parentPath: Object) {
   if (!parent) return;
   if (!opts) opts = {};
@@ -38,10 +34,6 @@ traverse.NodePath = require("./path");
 traverse.Scope    = require("./scope");
 traverse.Hub      = require("./hub");
 
-/**
- * [Please add a description.]
- */
-
 traverse.node = function (node: Object, opts: Object, scope: Object, state: Object, parentPath: Object, skipKeys?) {
   var keys = t.VISITOR_KEYS[node.type];
   if (!keys) return;
@@ -53,10 +45,6 @@ traverse.node = function (node: Object, opts: Object, scope: Object, state: Obje
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 const CLEAR_KEYS = t.COMMENT_KEYS.concat([
   "_scopeInfo", "_paths",
   "tokens", "comments",
@@ -64,10 +52,6 @@ const CLEAR_KEYS = t.COMMENT_KEYS.concat([
   "raw", "rawValue"
 ]);
 
-/**
- * [Please add a description.]
- */
-
 traverse.clearNode = function (node: Object) {
   for (var i = 0; i < CLEAR_KEYS.length; i++) {
     let key = CLEAR_KEYS[i];
@@ -75,19 +59,11 @@ traverse.clearNode = function (node: Object) {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var clearVisitor = {
   noScope: true,
   exit: traverse.clearNode
 };
 
-/**
- * [Please add a description.]
- */
-
 traverse.removeProperties = function (tree: Object): Object {
   traverse(tree, clearVisitor);
   traverse.clearNode(tree);
@@ -95,10 +71,6 @@ traverse.removeProperties = function (tree: Object): Object {
   return tree;
 };
 
-/**
- * [Please add a description.]
- */
-
 function hasBlacklistedType(node: Object, parent: Object, scope: Object, state: Object) {
   if (node.type === state.type) {
     state.has = true;
@@ -106,10 +78,6 @@ function hasBlacklistedType(node: Object, parent: Object, scope: Object, state:
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 traverse.hasType = function (tree: Object, scope: Object, type: Object, blacklistTypes: Array<string>): boolean {
   // the node we're searching in is blacklisted
   if (includes(blacklistTypes, tree.type)) return false;
diff --git a/packages/babel-traverse/src/path/README.md b/packages/babel-traverse/src/path/README.md
deleted file mode 100644
index 6459683030..0000000000
--- a/packages/babel-traverse/src/path/README.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## Path Traversal
-
-This is the Path Traversal directory.
-
- - `ancestry` - Methods that retrieve or validate anything related to the current paths ancestry.
- - `context` - Methods responsible for maintaing TraversalContexts.
- - `conversion` - Methods that convert the path node into another node or some other type of data.
- - `evaluation` - Methods responsible for statically evaluating code.
- - `inference` - Methods responsible for type inferrence etc.
- - `modification` - Methods that modify the path/node in some ways.
- - `replacement` - Methods responsible for replacing a node with another.
- - `removal` - Methods responsible for removing a node.
- - `family` - Methods responsible for dealing with/retrieving children or siblings.
- - `introspection` - Methods responsible for introspecting the current path for certain values.
- - `comments` - Methods responsible for dealing with comments.
diff --git a/packages/babel-traverse/src/path/ancestry.js b/packages/babel-traverse/src/path/ancestry.js
index 34515b509c..e1a1cfeff9 100644
--- a/packages/babel-traverse/src/path/ancestry.js
+++ b/packages/babel-traverse/src/path/ancestry.js
@@ -1,3 +1,5 @@
+// This file contains that retrieve or validate anything related to the current paths ancestry.
+
 import * as t from "babel-types";
 import NodePath from "./index";
 
@@ -161,10 +163,6 @@ export function getAncestry() {
   return paths;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function inType() {
   var path = this;
   while (path) {
diff --git a/packages/babel-traverse/src/path/comments.js b/packages/babel-traverse/src/path/comments.js
index dc7f0fcdaf..5c866d0590 100644
--- a/packages/babel-traverse/src/path/comments.js
+++ b/packages/babel-traverse/src/path/comments.js
@@ -1,3 +1,5 @@
+// This file contains methods responsible for dealing with comments.
+
 /**
  * Share comments amongst siblings.
  */
@@ -20,10 +22,6 @@ export function shareCommentsWithSiblings() {
   next.addComments("leading", trailing);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function addComment(type, content, line?) {
   this.addComments(type, [{
     type: line ? "CommentLine" : "CommentBlock",
diff --git a/packages/babel-traverse/src/path/context.js b/packages/babel-traverse/src/path/context.js
index 66af435037..17606a0def 100644
--- a/packages/babel-traverse/src/path/context.js
+++ b/packages/babel-traverse/src/path/context.js
@@ -1,8 +1,6 @@
-import traverse from "../index";
+// This file contains methods responsible for maintaining a TraversalContext.
 
-/**
- * [Please add a description.]
- */
+import traverse from "../index";
 
 export function call(key) {
   var node = this.node;
@@ -38,19 +36,11 @@ export function call(key) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function isBlacklisted(): boolean {
   var blacklist = this.opts.blacklist;
   return blacklist && blacklist.indexOf(this.node.type) > -1;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function visit(): boolean {
   if (this.isBlacklisted()) return false;
   if (this.opts.shouldSkip && this.opts.shouldSkip(this)) return false;
@@ -80,35 +70,19 @@ export function visit(): boolean {
   return this.shouldStop;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function skip() {
   this.shouldSkip = true;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function skipKey(key) {
   this.skipKeys[key] = true;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function stop() {
   this.shouldStop = true;
   this.shouldSkip = true;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function setScope() {
   if (this.opts && this.opts.noScope) return;
 
@@ -117,10 +91,6 @@ export function setScope() {
   if (this.scope) this.scope.init();
 }
 
-/**
- * [Please add a description.]
- */
-
 export function setContext(context) {
   this.shouldSkip = false;
   this.shouldStop = false;
@@ -153,20 +123,12 @@ export function resync() {
   //this._resyncRemoved();
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _resyncParent() {
   if (this.parentPath) {
     this.parent = this.parentPath.node;
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _resyncKey() {
   if (!this.container) return;
 
@@ -192,14 +154,10 @@ export function _resyncKey() {
   this.key = null;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _resyncList() {
   var listKey    = this.listKey;
   var parentPath = this.parentPath;
-  if (!listKey || !parentPath) return;
+  if (!listKey || !parentPath || !parentPath.node) return;
 
   var newContainer = parentPath.node[listKey];
   if (this.container === newContainer) return;
@@ -213,38 +171,22 @@ export function _resyncList() {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _resyncRemoved() {
   if (this.key == null || !this.container || this.container[this.key] !== this.node) {
     this._markRemoved();
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function shiftContext() {
   this.contexts.shift();
   this.setContext(this.contexts[0]);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function unshiftContext(context) {
   this.contexts.unshift(context);
   this.setContext(context);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function setup(parentPath, container, listKey, key) {
   this.inList    = !!listKey;
   this.listKey   = listKey;
@@ -255,20 +197,12 @@ export function setup(parentPath, container, listKey, key) {
   this.setKey(key);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function setKey(key) {
   this.key  = key;
   this.node = this.container[this.key];
   this.type = this.node && this.node.type;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function queueNode(path) {
   for (var context of (this.contexts: Array)) {
     if (context.queue) {
diff --git a/packages/babel-traverse/src/path/conversion.js b/packages/babel-traverse/src/path/conversion.js
index 071e324600..9a2347cf36 100644
--- a/packages/babel-traverse/src/path/conversion.js
+++ b/packages/babel-traverse/src/path/conversion.js
@@ -1,8 +1,6 @@
-import * as t from "babel-types";
+// This file contains methods that convert the path node into another node or some other type of data.
 
-/**
- * [Please add a description.]
- */
+import * as t from "babel-types";
 
 export function toComputedKey(): Object {
   var node = this.node;
@@ -23,10 +21,6 @@ export function toComputedKey(): Object {
   return key;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function ensureBlock() {
   return t.ensureBlock(this.node);
 }
diff --git a/packages/babel-traverse/src/path/evaluation.js b/packages/babel-traverse/src/path/evaluation.js
index 23f9bb75b8..5a39f556fd 100644
--- a/packages/babel-traverse/src/path/evaluation.js
+++ b/packages/babel-traverse/src/path/evaluation.js
@@ -1,3 +1,5 @@
+// This file contains Babels metainterpreter that can evaluate static code.
+
 /* eslint eqeqeq: 0 */
 
 const VALID_CALLEES = ["String", "Number", "Math"];
diff --git a/packages/babel-traverse/src/path/family.js b/packages/babel-traverse/src/path/family.js
index 99a2e7a2c6..38d57ef3c6 100644
--- a/packages/babel-traverse/src/path/family.js
+++ b/packages/babel-traverse/src/path/family.js
@@ -1,11 +1,9 @@
+// This file contains methods responsible for dealing with/retrieving children or siblings.
+
 import type TraversalContext from "../index";
 import NodePath from "./index";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export function getStatementParent(): ?NodePath {
   var path = this;
 
@@ -24,10 +22,6 @@ export function getStatementParent(): ?NodePath {
   return path;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function getOpposite() {
   if (this.key === "left") {
     return this.getSibling("right");
@@ -36,10 +30,6 @@ export function getOpposite() {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function getCompletionRecords(): Array {
   var paths = [];
 
@@ -67,10 +57,6 @@ export function getCompletionRecords(): Array {
   return paths;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function getSibling(key) {
   return NodePath.get({
     parentPath: this.parentPath,
@@ -81,10 +67,6 @@ export function getSibling(key) {
   });
 }
 
-/**
- * [Please add a description.]
- */
-
 export function get(key: string, context?: boolean | TraversalContext): NodePath {
   if (context === true) context = this.context;
   var parts = key.split(".");
@@ -95,10 +77,6 @@ export function get(key: string, context?: boolean | TraversalContext): NodePath
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _getKey(key, context?) {
   var node      = this.node;
   var container = node[key];
@@ -124,10 +102,6 @@ export function _getKey(key, context?) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _getPattern(parts, context) {
   var path = this;
   for (var part of (parts: Array)) {
@@ -144,10 +118,6 @@ export function _getPattern(parts, context) {
   return path;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function getBindingIdentifiers(duplicates?) {
   return t.getBindingIdentifiers(this.node, duplicates);
 }
diff --git a/packages/babel-traverse/src/path/index.js b/packages/babel-traverse/src/path/index.js
index 07b286d366..14e8c52b5f 100644
--- a/packages/babel-traverse/src/path/index.js
+++ b/packages/babel-traverse/src/path/index.js
@@ -1,19 +1,12 @@
 import * as virtualTypes from "./lib/virtual-types";
+import invariant from "invariant";
 import traverse from "../index";
 import assign from "lodash/object/assign";
 import Scope from "../scope";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default class NodePath {
 
-  /**
-   * [Please add a description.]
-   */
-
   constructor(hub, parent) {
     this.contexts = [];
     this.parent   = parent;
@@ -39,15 +32,13 @@ export default class NodePath {
     this.typeAnnotation     = null;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   static get({ hub, parentPath, parent, container, listKey, key }) {
     if (!hub && parentPath) {
       hub = parentPath.hub;
     }
 
+    invariant(parent, "To get a node path the parent needs to exist");
+
     var targetNode = container[key];
     var paths = parent._paths = parent._paths || [];
     var path;
@@ -70,10 +61,6 @@ export default class NodePath {
     return path;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getScope(scope: Scope) {
     var ourScope = scope;
 
@@ -85,44 +72,24 @@ export default class NodePath {
     return ourScope;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   setData(key, val) {
     return this.data[key] = val;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getData(key, def) {
     var val = this.data[key];
     if (!val && def) val = this.data[key] = def;
     return val;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   errorWithNode(msg, Error = SyntaxError) {
     return this.hub.file.errorWithNode(this.node, msg, Error);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   traverse(visitor, state) {
     traverse(this.node, visitor, this.scope, state, this);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   mark(type, message) {
     this.hub.file.metadata.marked.push({
       type,
@@ -130,11 +97,16 @@ export default class NodePath {
       loc: this.node.loc
     });
   }
-}
 
-/**
- * [Please add a description.]
- */
+  /**
+   * Description
+   */
+
+  set(key, node) {
+    t.validate(key, this.node, node);
+    this.node[key] = node;
+  }
+}
 
 assign(NodePath.prototype, require("./ancestry"));
 assign(NodePath.prototype, require("./inference"));
diff --git a/packages/babel-traverse/src/path/inference/README.md b/packages/babel-traverse/src/path/inference/README.md
deleted file mode 100644
index be4c8173da..0000000000
--- a/packages/babel-traverse/src/path/inference/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Inference
-
-This is the Inference directory.
diff --git a/packages/babel-traverse/src/path/inference/index.js b/packages/babel-traverse/src/path/inference/index.js
index 61bb0dc2b8..d3228a4e16 100644
--- a/packages/babel-traverse/src/path/inference/index.js
+++ b/packages/babel-traverse/src/path/inference/index.js
@@ -58,18 +58,10 @@ export function _getTypeAnnotation(): ?Object {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function isBaseType(baseName: string, soft?): boolean {
   return _isBaseType(baseName, this.getTypeAnnotation(), soft);
 }
 
-/**
- * [Please add a description.]
- */
-
 function _isBaseType(baseName: string, type?, soft?): boolean {
   if (baseName === "string") {
     return t.isStringTypeAnnotation(type);
@@ -92,10 +84,6 @@ function _isBaseType(baseName: string, type?, soft?): boolean {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function couldBeBaseType(name: string): boolean {
   var type = this.getTypeAnnotation();
   if (t.isAnyTypeAnnotation(type)) return true;
@@ -112,23 +100,15 @@ export function couldBeBaseType(name: string): boolean {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function baseTypeStrictlyMatches(right: NodePath) {
   var left = this.getTypeAnnotation();
   right = right.getTypeAnnotation();
 
-  if (!t.isAnyTypeAnnotation() && t.isFlowBaseAnnotation(left)) {
+  if (!t.isAnyTypeAnnotation(left) && t.isFlowBaseAnnotation(left)) {
     return right.type === left.type;
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function isGenericType(genericName: string): boolean {
   var type = this.getTypeAnnotation();
   return t.isGenericTypeAnnotation(type) && t.isIdentifier(type.id, { name: genericName });
diff --git a/packages/babel-traverse/src/path/inference/inferer-reference.js b/packages/babel-traverse/src/path/inference/inferer-reference.js
index eeb366a578..3f4a7a840a 100644
--- a/packages/babel-traverse/src/path/inference/inferer-reference.js
+++ b/packages/babel-traverse/src/path/inference/inferer-reference.js
@@ -1,9 +1,5 @@
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export default function (node) {
   if (!this.isReferenced()) return;
 
@@ -28,10 +24,6 @@ export default function (node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function getTypeAnnotationBindingConstantViolations(path, name) {
   var binding = path.scope.getBinding(name);
 
@@ -85,10 +77,6 @@ function getTypeAnnotationBindingConstantViolations(path, name) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function getConstantViolationsBefore(binding, path, functions) {
   var violations = binding.constantViolations.slice();
   violations.unshift(binding.path);
@@ -100,10 +88,6 @@ function getConstantViolationsBefore(binding, path, functions) {
   });
 }
 
-/**
- * [Please add a description.]
- */
-
 function inferAnnotationFromBinaryExpression(name, path) {
   var operator = path.node.operator;
 
@@ -155,10 +139,6 @@ function inferAnnotationFromBinaryExpression(name, path) {
   return t.createTypeAnnotationBasedOnTypeof(typePath.node.value);
 }
 
-/**
- * [Please add a description.]
- */
-
 function getParentConditionalPath(path) {
   var parentPath;
   while (parentPath = path.parentPath) {
@@ -174,10 +154,6 @@ function getParentConditionalPath(path) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 function getConditionalAnnotation(path, name) {
   var ifStatement = getParentConditionalPath(path);
   if (!ifStatement) return;
diff --git a/packages/babel-traverse/src/path/inference/inferers.js b/packages/babel-traverse/src/path/inference/inferers.js
index 94eca85d43..f36b977bc9 100644
--- a/packages/babel-traverse/src/path/inference/inferers.js
+++ b/packages/babel-traverse/src/path/inference/inferers.js
@@ -2,10 +2,6 @@ import * as t from "babel-types";
 
 export { default as Identifier } from "./inferer-reference";
 
-/**
- * [Please add a description.]
- */
-
 export function VariableDeclarator() {
   var id = this.get("id");
 
@@ -16,20 +12,12 @@ export function VariableDeclarator() {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function TypeCastExpression(node) {
   return node.typeAnnotation;
 }
 
 TypeCastExpression.validParent = true;
 
-/**
- * [Please add a description.]
- */
-
 export function NewExpression(node) {
   if (this.get("callee").isIdentifier()) {
     // only resolve identifier callee
@@ -37,18 +25,10 @@ export function NewExpression(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function TemplateLiteral() {
   return t.stringTypeAnnotation();
 }
 
-/**
- * [Please add a description.]
- */
-
 export function UnaryExpression(node) {
   let operator = node.operator;
 
@@ -63,10 +43,6 @@ export function UnaryExpression(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function BinaryExpression(node) {
   let operator = node.operator;
 
@@ -94,10 +70,6 @@ export function BinaryExpression(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function LogicalExpression() {
   return t.createUnionTypeAnnotation([
     this.get("left").getTypeAnnotation(),
@@ -105,10 +77,6 @@ export function LogicalExpression() {
   ]);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function ConditionalExpression() {
   return t.createUnionTypeAnnotation([
     this.get("consequent").getTypeAnnotation(),
@@ -116,26 +84,14 @@ export function ConditionalExpression() {
   ]);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function SequenceExpression() {
   return this.get("expressions").pop().getTypeAnnotation();
 }
 
-/**
- * [Please add a description.]
- */
-
 export function AssignmentExpression() {
   return this.get("right").getTypeAnnotation();
 }
 
-/**
- * [Please add a description.]
- */
-
 export function UpdateExpression(node) {
   let operator = node.operator;
   if (operator === "++" || operator === "--") {
@@ -143,10 +99,6 @@ export function UpdateExpression(node) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function Literal(node) {
   var value = node.value;
   if (typeof value === "string") return t.stringTypeAnnotation();
@@ -156,62 +108,34 @@ export function Literal(node) {
   if (node.regex) return t.genericTypeAnnotation(t.identifier("RegExp"));
 }
 
-/**
- * [Please add a description.]
- */
-
 export function ObjectExpression() {
   return t.genericTypeAnnotation(t.identifier("Object"));
 }
 
-/**
- * [Please add a description.]
- */
-
 export function ArrayExpression() {
   return t.genericTypeAnnotation(t.identifier("Array"));
 }
 
-/**
- * [Please add a description.]
- */
-
 export function RestElement() {
   return ArrayExpression();
 }
 
 RestElement.validParent = true;
 
-/**
- * [Please add a description.]
- */
-
 function Func() {
   return t.genericTypeAnnotation(t.identifier("Function"));
 }
 
 export { Func as Function, Func as Class };
 
-/**
- * [Please add a description.]
- */
-
 export function CallExpression() {
   return resolveCall(this.get("callee"));
 }
 
-/**
- * [Please add a description.]
- */
-
 export function TaggedTemplateExpression() {
   return resolveCall(this.get("tag"));
 }
 
-/**
- * [Please add a description.]
- */
-
 function resolveCall(callee) {
   callee = callee.resolve();
 
diff --git a/packages/babel-traverse/src/path/introspection.js b/packages/babel-traverse/src/path/introspection.js
index 4b644e5637..d68fb17869 100644
--- a/packages/babel-traverse/src/path/introspection.js
+++ b/packages/babel-traverse/src/path/introspection.js
@@ -1,3 +1,5 @@
+// This file contains methods responsible for introspecting the current path for certain values.
+
 import type NodePath from "./index";
 import includes from "lodash/collection/includes";
 import * as t from "babel-types";
@@ -209,10 +211,6 @@ export function getSource() {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function willIMaybeExecuteBefore(target) {
   return this._guessExecutionStatusRelativeTo(target) !== "after";
 }
@@ -279,10 +277,6 @@ export function resolve(dangerous, resolved) {
   return this._resolve(dangerous, resolved) || this;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _resolve(dangerous?, resolved?): ?NodePath {
   // detect infinite recursion
   // todo: possibly have a max length on this just to be safe
diff --git a/packages/babel-traverse/src/path/lib/hoister.js b/packages/babel-traverse/src/path/lib/hoister.js
index 505fc01b80..dc4a71e317 100644
--- a/packages/babel-traverse/src/path/lib/hoister.js
+++ b/packages/babel-traverse/src/path/lib/hoister.js
@@ -1,16 +1,8 @@
 import { react } from "babel-types";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var referenceVisitor = {
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     if (this.isJSXIdentifier() && react.isCompatTag(node.name)) {
       return;
@@ -34,10 +26,6 @@ var referenceVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class PathHoister {
   constructor(path, scope) {
     this.breakOnScopePaths = [];
@@ -47,10 +35,6 @@ export default class PathHoister {
     this.path              = path;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   isCompatibleScope(scope) {
     for (var key in this.bindings) {
       var binding = this.bindings[key];
@@ -62,10 +46,6 @@ export default class PathHoister {
     return true;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getCompatibleScopes() {
     var scope = this.path.scope;
     do {
@@ -81,10 +61,6 @@ export default class PathHoister {
     } while(scope = scope.parent);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getAttachmentPath() {
     var scopes = this.scopes;
 
@@ -107,19 +83,11 @@ export default class PathHoister {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getNextScopeStatementParent() {
     var scope = this.scopes.pop();
     if (scope) return scope.path.getStatementParent();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasOwnParamBindings(scope) {
     for (var name in this.bindings) {
       if (!scope.hasOwnBinding(name)) continue;
@@ -130,10 +98,6 @@ export default class PathHoister {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   run() {
     var node = this.path.node;
     if (node._hoisted) return;
diff --git a/packages/babel-traverse/src/path/lib/removal-hooks.js b/packages/babel-traverse/src/path/lib/removal-hooks.js
index 7b2d0c8fed..4b8749f7e8 100644
--- a/packages/babel-traverse/src/path/lib/removal-hooks.js
+++ b/packages/babel-traverse/src/path/lib/removal-hooks.js
@@ -8,10 +8,6 @@ import * as t from "babel-types";
 
 export var pre = [
 
-  /**
-   * [Please add a description.]
-   */
-
   function (self) {
     if (self.key === "body" && (self.isBlockStatement() || self.isClassBody())) {
       // function () NODE
@@ -23,10 +19,6 @@ export var pre = [
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   function (self, parent) {
     var replace = false;
 
@@ -51,10 +43,6 @@ export var pre = [
 
 export var post = [
 
-  /**
-   * [Please add a description.]
-   */
-
   function (self, parent) {
     var removeParent = false;
 
@@ -90,10 +78,6 @@ export var post = [
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   function (self, parent) {
     if (parent.isSequenceExpression() && parent.node.expressions.length === 1) {
       // (node, NODE);
@@ -104,10 +88,6 @@ export var post = [
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   function (self, parent) {
     if (parent.isBinary()) {
       // left + NODE;
diff --git a/packages/babel-traverse/src/path/lib/virtual-types.js b/packages/babel-traverse/src/path/lib/virtual-types.js
index 591041aaa5..897c1b70ed 100644
--- a/packages/babel-traverse/src/path/lib/virtual-types.js
+++ b/packages/babel-traverse/src/path/lib/virtual-types.js
@@ -1,10 +1,6 @@
 import { react } from "babel-types";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 export var ReferencedIdentifier = {
   types: ["Identifier", "JSXIdentifier"],
   checkPath({ node, parent }, opts) {
@@ -22,10 +18,6 @@ export var ReferencedIdentifier = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var BindingIdentifier = {
   types: ["Identifier"],
   checkPath({ node, parent }) {
@@ -33,10 +25,6 @@ export var BindingIdentifier = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Statement = {
   types: ["Statement"],
   checkPath({ node, parent }) {
@@ -53,10 +41,6 @@ export var Statement = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Expression = {
   types: ["Expression"],
   checkPath(path) {
@@ -68,10 +52,6 @@ export var Expression = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Scope = {
   types: ["Scopable"],
   checkPath(path) {
@@ -79,30 +59,18 @@ export var Scope = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Referenced = {
   checkPath(path) {
     return t.isReferenced(path.node, path.parent);
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var BlockScoped = {
   checkPath(path) {
     return t.isBlockScoped(path.node);
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Var = {
   types: ["VariableDeclaration"],
   checkPath(path) {
@@ -110,10 +78,6 @@ export var Var = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var DirectiveLiteral = {
   types: ["Literal"],
   checkPath(path) {
@@ -121,10 +85,6 @@ export var DirectiveLiteral = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Directive = {
   types: ["ExpressionStatement"],
   checkPath({ inList, container, key }) {
@@ -146,30 +106,18 @@ export var Directive = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var User = {
   checkPath(path) {
     return path.node && !!path.node.loc;
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Generated = {
   checkPath(path) {
     return !path.isUser();
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export var Flow = {
   types: ["Flow", "ImportDeclaration", "ExportDeclaration"],
   checkPath({ node }) {
diff --git a/packages/babel-traverse/src/path/modification.js b/packages/babel-traverse/src/path/modification.js
index 4d69086e5e..cd117f3b3b 100644
--- a/packages/babel-traverse/src/path/modification.js
+++ b/packages/babel-traverse/src/path/modification.js
@@ -1,3 +1,5 @@
+// This file contains methods that modify the path/node in some ways.
+
 import PathHoister from "./lib/hoister";
 import NodePath from "./index";
 import * as t from "babel-types";
@@ -31,10 +33,6 @@ export function insertBefore(nodes) {
   return [this];
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _containerInsert(from, nodes) {
   this.updateSiblingKeys(from, nodes.length);
 
@@ -63,26 +61,14 @@ export function _containerInsert(from, nodes) {
   return paths;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _containerInsertBefore(nodes) {
   return this._containerInsert(this.key, nodes);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _containerInsertAfter(nodes) {
   return this._containerInsert(this.key + 1, nodes);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _maybePopFromStatements(nodes) {
   var last = nodes[nodes.length - 1];
   if (t.isExpressionStatement(last) && t.isIdentifier(last.expression) && !this.isCompletionRecord()) {
@@ -138,10 +124,6 @@ export function updateSiblingKeys(fromIndex, incrementBy) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _verifyNodeList(nodes) {
   if (nodes.constructor !== Array) {
     nodes = [nodes];
@@ -163,10 +145,6 @@ export function _verifyNodeList(nodes) {
   return nodes;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function unshiftContainer(listKey, nodes) {
   this._assertUnremoved();
 
@@ -187,10 +165,6 @@ export function unshiftContainer(listKey, nodes) {
   return path.insertBefore(nodes);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function pushContainer(listKey, nodes) {
   this._assertUnremoved();
 
diff --git a/packages/babel-traverse/src/path/removal.js b/packages/babel-traverse/src/path/removal.js
index 4703465dd1..f5a042fbe0 100644
--- a/packages/babel-traverse/src/path/removal.js
+++ b/packages/babel-traverse/src/path/removal.js
@@ -1,3 +1,5 @@
+// This file contains methods responsible for removing a node.
+
 import * as removalHooks from "./lib/removal-hooks";
 
 /**
@@ -32,19 +34,12 @@ export function dangerouslyRemove() {
   this._callRemovalHooks("post");
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _callRemovalHooks(position) {
   for (var fn of (removalHooks[position]: Array)) {
     if (fn(this, this.parentPath)) return true;
   }
 }
 
-/**
- * [Please add a description.]
- */
 
 export function _remove() {
   if (Array.isArray(this.container)) {
@@ -55,20 +50,12 @@ export function _remove() {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _markRemoved() {
   this.shouldSkip = true;
   this.removed    = true;
   this.node       = null;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function _assertUnremoved() {
   if (this.removed) {
     throw this.errorWithNode("NodePath has been removed so is read-only.");
diff --git a/packages/babel-traverse/src/path/replacement.js b/packages/babel-traverse/src/path/replacement.js
index e3113feecd..e8cdf75b3c 100644
--- a/packages/babel-traverse/src/path/replacement.js
+++ b/packages/babel-traverse/src/path/replacement.js
@@ -1,27 +1,17 @@
+// This file contains methods responsible for replacing a node with another.
+
 import codeFrame from "babel-code-frame";
 import traverse from "../index";
 import NodePath from "./index";
 import { parse } from "babylon";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var hoistVariablesVisitor = {
 
-  /**
-   * [Please add a description.]
-   */
-
   Function() {
     this.skip();
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   VariableDeclaration(node, parent, scope) {
     if (node.kind !== "var") return;
 
@@ -199,10 +189,6 @@ export function replaceExpressionWithStatements(nodes: Array) {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function replaceInline(nodes) {
   this.resync();
 
diff --git a/packages/babel-traverse/src/scope/README.md b/packages/babel-traverse/src/scope/README.md
deleted file mode 100644
index e63b7d3d06..0000000000
--- a/packages/babel-traverse/src/scope/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## Scope Traversal
-
-This is the Scope Traversal directory.
diff --git a/packages/babel-traverse/src/scope/binding.js b/packages/babel-traverse/src/scope/binding.js
index 0ccd33b38f..680e181ed5 100644
--- a/packages/babel-traverse/src/scope/binding.js
+++ b/packages/babel-traverse/src/scope/binding.js
@@ -15,6 +15,7 @@ export default class Binding {
     this.constant           = true;
 
     this.identifier = identifier;
+    this.referencePaths = [];
     this.references = 0;
     this.referenced = false;
 
@@ -37,29 +38,17 @@ export default class Binding {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   deoptValue() {
     this.clearValue();
     this.hasDeoptedValue = true;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   setValue(value: any) {
     if (this.hasDeoptedValue) return;
     this.hasValue = true;
     this.value    = value;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   clearValue() {
     this.hasDeoptedValue = false;
     this.hasValue        = false;
@@ -79,9 +68,10 @@ export default class Binding {
    * Increment the amount of references to this binding.
    */
 
-  reference() {
+  reference(path) {
     this.referenced = true;
     this.references++;
+    this.referencePaths.push(path)
   }
 
   /**
diff --git a/packages/babel-traverse/src/scope/index.js b/packages/babel-traverse/src/scope/index.js
index 2a27289bd5..accbbb1f3d 100644
--- a/packages/babel-traverse/src/scope/index.js
+++ b/packages/babel-traverse/src/scope/index.js
@@ -10,16 +10,8 @@ import flatten from "lodash/array/flatten";
 import extend from "lodash/object/extend";
 import * as t from "babel-types";
 
-/**
- * [Please add a description.]
- */
-
 var collectorVisitor = {
 
-  /**
-   * [Please add a description.]
-   */
-
   For(node, parent, scope) {
     for (var key of (t.FOR_INIT_KEYS: Array)) {
       var declar = this.get(key);
@@ -27,10 +19,6 @@ var collectorVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Declaration(node, parent, scope) {
     // delegate block scope handling to the `blockVariableVisitor`
     if (this.isBlockScoped()) return;
@@ -42,10 +30,6 @@ var collectorVisitor = {
     scope.getFunctionParent().registerDeclaration(this);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node) {
     var binding = this.scope.getBinding(node.name);
     if (binding) {
@@ -55,10 +39,6 @@ var collectorVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ForXStatement() {
     var left = this.get("left");
     if (left.isPattern() || left.isIdentifier()) {
@@ -66,10 +46,6 @@ var collectorVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ExportDeclaration: {
     exit(node) {
       var declar = node.declaration;
@@ -86,19 +62,11 @@ var collectorVisitor = {
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   LabeledStatement(node) {
     this.scope.getProgramParent().addGlobal(node);
     this.scope.getBlockParent().registerDeclaration(this);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   AssignmentExpression() {
     // register undeclared bindings as globals
     var ids = this.getBindingIdentifiers();
@@ -114,44 +82,24 @@ var collectorVisitor = {
     this.scope.registerConstantViolation(this, this.get("left"), this.get("right"));
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   UpdateExpression(node, parent, scope) {
     scope.registerConstantViolation(this, this.get("argument"), null);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   UnaryExpression(node, parent, scope) {
     if (node.operator === "delete") scope.registerConstantViolation(this, this.get("left"), null);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   BlockScoped(node, parent, scope) {
     if (scope.path === this) scope = scope.parent;
     scope.getBlockParent().registerDeclaration(this);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   ClassDeclaration(node, parent, scope) {
     var name = node.id.name;
     scope.bindings[name] = scope.getBinding(name);
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Block(node, parent, scope) {
     var paths = this.get("body");
     for (var path of (paths: Array)) {
@@ -162,26 +110,14 @@ var collectorVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 var renameVisitor = {
 
-  /**
-   * [Please add a description.]
-   */
-
   ReferencedIdentifier(node, parent, scope, state) {
     if (node.name === state.oldName) {
       node.name = state.newName;
     }
   },
 
-  /**
-   * [Please add a description.]
-   */
-
   Scope(node, parent, scope, state) {
     if (!scope.bindingIdentifierEquals(state.oldName, state.binding)) {
       this.skip();
@@ -197,10 +133,6 @@ var renameVisitor = {
   }
 };
 
-/**
- * [Please add a description.]
- */
-
 export default class Scope {
 
   /**
@@ -398,10 +330,6 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   checkBlockScopedCollisions(local, kind: string, name: string, id: Object) {
     // ignore parameters
     if (kind === "param") return;
@@ -422,10 +350,6 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   rename(oldName: string, newName: string, block?) {
     newName = newName || this.generateUidIdentifier(oldName).name;
 
@@ -455,10 +379,6 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   _renameFromMap(map, oldName, newName, value) {
     if (map[oldName]) {
       map[newName] = value;
@@ -466,10 +386,6 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   dump() {
     var sep = repeating("-", 60);
     console.log(sep);
@@ -488,10 +404,6 @@ export default class Scope {
     console.log(sep);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   toArray(node: Object, i?: number) {
     var file = this.hub.file;
 
@@ -520,10 +432,6 @@ export default class Scope {
     return t.callExpression(file.addHelper(helperName), args);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   registerDeclaration(path: NodePath) {
     if (path.isLabeledStatement()) {
       this.registerBinding("label", path);
@@ -551,10 +459,6 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   registerConstantViolation(root: NodePath, left: NodePath, right: NodePath) {
     var ids = left.getBindingIdentifiers();
     for (var name in ids) {
@@ -563,10 +467,6 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   registerBinding(kind: string, path: NodePath) {
     if (!kind) throw new ReferenceError("no `kind`");
 
@@ -605,18 +505,10 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   addGlobal(node: Object) {
     this.globals[node.name] = node;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasUid(name): boolean {
     var scope = this;
 
@@ -627,10 +519,6 @@ export default class Scope {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasGlobal(name: string): boolean {
     var scope = this;
 
@@ -641,10 +529,6 @@ export default class Scope {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasReference(name: string): boolean {
     var scope = this;
 
@@ -655,10 +539,6 @@ export default class Scope {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   isPure(node, constantsOnly?: boolean) {
     if (t.isIdentifier(node)) {
       var binding = this.getBinding(node.name);
@@ -720,18 +600,10 @@ export default class Scope {
     } while(scope = scope.parent);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   init() {
     if (!this.references) this.crawl();
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   crawl() {
     var path = this.path;
 
@@ -804,10 +676,6 @@ export default class Scope {
     this.crawling = false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   push(opts: Object) {
     var path = this.path;
 
@@ -928,18 +796,10 @@ export default class Scope {
     return ids;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   bindingIdentifierEquals(name: string, node: Object): boolean {
     return this.getBindingIdentifier(name) === node;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getBinding(name: string) {
     var scope = this;
 
@@ -949,44 +809,24 @@ export default class Scope {
     } while (scope = scope.parent);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getOwnBinding(name: string) {
     return this.bindings[name];
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getBindingIdentifier(name: string) {
     var info = this.getBinding(name);
     return info && info.identifier;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   getOwnBindingIdentifier(name: string) {
     var binding = this.bindings[name];
     return binding && binding.identifier;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasOwnBinding(name: string) {
     return !!this.getOwnBinding(name);
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   hasBinding(name: string, noGlobals?) {
     if (!name) return false;
     if (this.hasOwnBinding(name)) return true;
@@ -997,10 +837,6 @@ export default class Scope {
     return false;
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   parentHasBinding(name: string, noGlobals?) {
     return this.parent && this.parent.hasBinding(name, noGlobals);
   }
@@ -1018,18 +854,10 @@ export default class Scope {
     }
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   removeOwnBinding(name: string) {
     delete this.bindings[name];
   }
 
-  /**
-   * [Please add a description.]
-   */
-
   removeBinding(name: string) {
     // clear literal binding
     var info = this.getBinding(name);
diff --git a/packages/babel-types/README.md b/packages/babel-types/README.md
new file mode 100644
index 0000000000..a71a129964
--- /dev/null
+++ b/packages/babel-types/README.md
@@ -0,0 +1 @@
+# babel-types
diff --git a/packages/babel-types/src/converters.js b/packages/babel-types/src/converters.js
index 1a01e069d1..694df04240 100644
--- a/packages/babel-types/src/converters.js
+++ b/packages/babel-types/src/converters.js
@@ -6,10 +6,6 @@ import traverse from "babel-traverse";
 import type { Scope } from "babel-traverse";
 import * as t from "./index";
 
-/**
- * [Please add a description.]
- */
-
 export function toComputedKey(node: Object, key: Object = node.key || node.property): Object {
   if (!node.computed) {
     if (t.isIdentifier(key)) key = t.stringLiteral(key.name);
@@ -27,6 +23,8 @@ export function toComputedKey(node: Object, key: Object = node.key || node.prope
  */
 
 export function toSequenceExpression(nodes: Array<Object>, scope: Scope): Object {
+  if (!nodes || !nodes.length) return;
+
   var declars = [];
   var bailed  = false;
 
@@ -101,10 +99,6 @@ export function toSequenceExpression(nodes: Array<Object>, scope: Scope): Object
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toKeyAlias(node: Object, key: Object = node.key) {
   var alias;
 
@@ -127,10 +121,6 @@ export function toKeyAlias(node: Object, key: Object = node.key) {
 
 toKeyAlias.uid = 0;
 
-/**
- * [Please add a description.]
- */
-
 export function toIdentifier(name: string): string {
   if (t.isIdentifier(name)) return name.name;
 
@@ -154,10 +144,6 @@ export function toIdentifier(name: string): string {
   return name || "_";
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toBindingIdentifierName(name) {
   name = toIdentifier(name);
   if (name === "eval" || name === "arguments") name = "_" + name;
@@ -204,10 +190,6 @@ export function toStatement(node: Object, ignore?: boolean) {
   return node;
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toExpression(node: Object): Object {
   if (t.isExpressionStatement(node)) {
     node = node.expression;
@@ -226,10 +208,6 @@ export function toExpression(node: Object): Object {
   }
 }
 
-/**
- * [Please add a description.]
- */
-
 export function toBlock(node: Object, parent: Object): Object {
   if (t.isBlockStatement(node)) {
     return node;
@@ -254,10 +232,6 @@ export function toBlock(node: Object, parent: Object): Object {
   return t.blockStatement(node);
 }
 
-/**
- * [Please add a description.]
- */
-
 export function valueToNode(value: any): Object {
   // undefined
   if (value === undefined) {