diff --git a/src/lib/autocomplete/OVERVIEW.md b/src/lib/autocomplete/OVERVIEW.md
new file mode 100644
index 000000000000..23829d205924
--- /dev/null
+++ b/src/lib/autocomplete/OVERVIEW.md
@@ -0,0 +1,149 @@
+
+The autocomplete is a normal text input enhanced by a panel of suggested options. You can read more about
+autocompletes in the [Material Design spec](https://material.io/guidelines/components/text-fields.html#text-fields-auto-complete-text-field).
+
+### Simple autocomplete
+
+Start by adding a regular `mdInput` to the page. Let's assume you're using the `formControl` directive from the
+`@angular/forms` module to track the value of the input.
+
+*my-comp.html*
+```html
+
+
+
+```
+
+Next, create the autocomplete panel and the options displayed inside it. Each option should be defined by an
+`md-option` tag. Set each option's value property to whatever you'd like the value of the text input to be
+upon that option's selection.
+
+*my-comp.html*
+```html
+
+
+ {{ option }}
+
+
+```
+
+Now we'll need to link the text input to its panel. We can do this by exporting the autocomplete panel instance into a
+local template variable (here we called it "auto"), and binding that variable to the input's `mdAutocomplete` property.
+
+*my-comp.html*
+```html
+
+
+
+
+
+
+ {{ option }}
+
+
+```
+
+### Adding a custom filter
+
+At this point, the autocomplete panel should be toggleable on focus and options should be selectable. But if we want
+our options to filter when we type, we need to add a custom filter.
+
+We already have access to the built-in `valueChanges` observable on the `FormControl`, so we can simply map the text
+input's values to the suggested options by passing them through our filter function. The resulting observable
+(`filteredOptions`) can be added to the template in place of the `options` property using the `async` pipe.
+
+Below we are also priming our value change stream with `null` so that the options are filtered by that value on init
+(before there are any value changes).
+
+*my-comp.ts*
+```ts
+class MyComp {
+ myControl = new FormControl();
+ options = [
+ 'One',
+ 'Two',
+ 'Three'
+ ];
+ filteredOptions: Observable;
+
+ ngOnInit() {
+ this.filteredOptions = this.myControl.valueChanges
+ .startWith(null)
+ .map(val => val ? this.filter(val) : this.options.slice());
+ }
+
+ filter(val: string): string[] {
+ return this.options.filter(option => option.match(new RegExp(val, 'gi')));
+ }
+}
+```
+
+*my-comp.html*
+```html
+
+
+
+
+
+
+ {{ option }}
+
+
+```
+
+### Setting separate control and display values
+
+If you want the option's control value (what is saved in the form) to be different than the option's display value
+(what is displayed in the actual text field), you'll need to set the `displayWith` property on your autocomplete
+element. A common use case for this might be if you want to save your data as an object, but display just one of
+the option's string properties.
+
+To make this work, create a function on your component class that maps the control value to the desired display value.
+Then bind it to the autocomplete's `displayWith` property. You'll probably also want to add a step to your
+`valueChanges` stream that maps the value through your display function.
+
+```html
+
+
+
+
+
+
+ {{ option }}
+
+
+```
+
+*my-comp.ts*
+```ts
+class MyComp {
+ myControl = new FormControl();
+ options = [
+ {id: 1, name: 'One'},
+ {id: 2, name: 'Two'},
+ {id: 3, name: 'Three'}
+ ];
+ filteredOptions: Observable;
+
+ ngOnInit() {
+ this.filteredOptions = this.myControl.valueChanges
+ .startWith(null)
+ .map(val => this.displayFn(val))
+ .map(name => name ? this.filter(name) : this.options.slice());
+ }
+
+ filter(val: string): string[] {
+ return this.options.filter(option => option.match(new RegExp(this.displayFn(val), 'gi')));
+ }
+
+ displayFn(value: any): string {
+ return value && typeof value === 'object' ? value.name : value;
+ }
+}
+```
+
+
+#### Keyboard interaction:
+- DOWN_ARROW: Next option becomes active.
+- UP_ARROW: Previous option becomes active.
+- ENTER: Select currently active item.
diff --git a/src/lib/autocomplete/README.md b/src/lib/autocomplete/README.md
index 1bc0814e9eec..73bddeb68ee6 100644
--- a/src/lib/autocomplete/README.md
+++ b/src/lib/autocomplete/README.md
@@ -1,5 +1 @@
-
-## Not yet implemented!
-
-The autocomplete is not yet implemented. This is only a scaffold to make
-subsequent PRs easier to read. Please do not try to use yet :)
\ No newline at end of file
+See documentation on [material.angular.io](https://material.angular.io/).
\ No newline at end of file