diff --git a/docs/articles/manifest.json b/docs/articles/manifest.json
index f5e85491..b9801fb6 100644
--- a/docs/articles/manifest.json
+++ b/docs/articles/manifest.json
@@ -9,5 +9,8 @@
{
"key":"grid_intro",
"children":["grid_config", "grid_data_integration"]
+ },
+ {
+ "key":"migration_guide"
}
]
\ No newline at end of file
diff --git a/docs/articles/migration_guide.md b/docs/articles/migration_guide.md
new file mode 100644
index 00000000..3a0f230e
--- /dev/null
+++ b/docs/articles/migration_guide.md
@@ -0,0 +1,60 @@
+# Migration Guide
+Strand is now built on Polymer 1.0. This article will only document breaking changes to the Strand APIs. For breaking changes between the 0.5 and 1.0 release of Polymer, see the Polymer migration guide.
+
+### mm-icon
+`primaryColor` and `hoverColor` properties have been deprecated. Color should instead be configured in stylesheets.
+
+Before:
+```html
+
+```
+
+After:
+```html
+
+
+```
+
+---
+
+### mm-input
+Autocompleting `mm-input` is now a separate component, `mm-autocomplete`
+
+Before:
+```html
+
+```
+
+After:
+```html
+
+```
+
+---
+
+### mm-tooltip
+`mm-tooltip` no longer requires a template tag. The tooltip's target should be moved outside of the component, and a selector should be passed to tooltip using the `target` attribute.
+
+Before:
+```html
+
+
+
+
+
+
+```
+After:
+```html
+
+
+
+
+```
\ No newline at end of file