Began migration guide

weierophinney · weierophinney · commit 408e7ff9fcbc · 2013-02-27T15:10:01.000-06:00
diff --git a/docs/languages/en/index.rst b/docs/languages/en/index.rst
@@ -24,6 +24,7 @@
    modules/zendtool.introduction
    tutorials/quickstart.di
    tutorials/unittesting
+   migration/overview
    modules/zend.authentication.intro
    modules/zend.authentication.adapter.dbtable
    modules/zend.authentication.adapter.digest
@@ -287,6 +288,11 @@
     * :doc:`tutorials/quickstart.di`
     * :doc:`tutorials/unittesting`
 
+|Migration|
+-----------
+
+    * :doc:`migration/overview`
+
 |ZendFrameworkReference|
 ------------------------
 
diff --git a/docs/languages/en/migration/overview.rst b/docs/languages/en/migration/overview.rst
@@ -0,0 +1,18 @@
+.. _migration.overview:
+
+Migration from Zend Framework 1
+===============================
+
+This guide is intended to provide tools and strategies for migrating from Zend
+Framework 1 to Zend Framework 2. There is no single solution that will work for
+every project, nor any tools to automate the process.
+
+In this guide, we will cover the following:
+
+* Tools for namespacing your code.
+* Tools for consuming Zend Framework 2 within your Zend Framework 1 application.
+* Strategies for running Zend Framework 2 and Zend Framework 1 in parallel.
+* Strategies for making your code easier to migrate, focussing primarily on
+  clean separation of your domain logic and the MVC layer.
+* Strategies for migrating the MVC layer.
+* Strategies for migrating your domain layer.
