Add a quick elevator pitch to the README.

1 files changed, 51 insertions, 5 deletions

diff --git a/README.md b/README.md
index 4aa28875..a5b452ac 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,58 @@
 AutoFactory
 ======
 
-A source code generator for JSR-330-compatible factories
+A source code generator for JSR-330-compatible factories.
 
-For more information please see [the website][1].
+What is this?
+-------------
 
+[Java](https://en.wikipedia.org/wiki/Java_(programming_language)) is full of [factories](http://en.wikipedia.org/wiki/Factory_method_pattern).  They're mechanical, repetitive, typically untested and sometimes the source of subtle bugs. _Sounds like a job for robots!_
+
+AutoFactory generates factories that can be used on their own or with [JSR-330](http://jcp.org/en/jsr/detail?id=330)-compatible [dependency injectors](http://en.wikipedia.org/wiki/Dependency_injection) from a simple annotation.
+
+Save time.  Save code.  Save sanity.
+
+Example
+-------
+
+Say you have:
+
+```java
+@AutoFactory
+final class SomeClass {
+  private final String providedDepA;
+  private final String depB;
+
+  SomeClass(@Provided @AQualifier String providedDepA, String depB) {
+    this.providedDepA = providedDepA;
+    this.depB = depB;
+  }
+
+  …
+}
+```
+
+AutoFactory will generate:
+
+```java
+import javax.annotation.Generated;
+import javax.inject.Inject;
+import javax.inject.Provider;
+
+@Generated(value = "com.google.autofactory.AutoFactoryProcessor")
+final class SimpleClassMixedDepsFactory {
+  private final Provider<String> providedDepAProvider;
+  
+  @Inject SimpleClassMixedDepsFactory(
+      @AQualifier Provider<String> providedDepAProvider) {
+    this.providedDepAProvider = providedDepAProvider;
+  }
+  
+  SimpleClassMixedDeps create(String depB) {
+    return new SimpleClassMixedDeps(providedDepAProvider.get(), depB);
+  }
+}
+```
 
 Download
 --------
@@ -27,7 +75,7 @@ artifact as an "optional" dependency:
 </dependencies>
 ```
 
-You can also find downloadable .jars on the [GitHub download page][2].
+You can also find downloadable .jars on the [GitHub download page](http://github.com/google/autofactory/downloads).
 
 
 
@@ -50,5 +98,3 @@ License
 
 
 
- [1]: http://google.github.com/autofactory/
- [2]: http://github.com/google/autofactory/downloads