diff --git a/packages/babel-generator/README.md b/packages/babel-generator/README.md
index a71b28d699..c3b743049e 100644
--- a/packages/babel-generator/README.md
+++ b/packages/babel-generator/README.md
@@ -1 +1,21 @@
 # babel-generator
+
+> Turns an AST into code.
+
+## Install
+
+```sh
+$ npm install babel-generator
+```
+
+## Usage
+
+```js
+import {parse} from 'babylon';
+import generate from 'babel-generator';
+
+const code = 'class Example {}';
+const ast = parse(ast);
+
+const output = generate(ast, { /* options */ }, code);
+```