diff --git a/README.md b/README.md
index a02bb22f34665d63d5d673e6a5c1dd1de3f6ab7c..720b1c7772a8f4650dd1e53f5a5c2a7485a48424 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,24 @@ This question can be solved by creating:
 
 ## Installation and upgrade of FusionDirectory
 
-The installation and upgrade information is available on [fusiondirectory-install]
+The installation and upgrade information is available on [Install FusionDirectory][fusiondirectory-install]
+
+## Migration to FusionDirectory
+
+To migrate an existing LDAP tree, you've to do all steps [Install FusionDirectory][fusiondirectory-install],
+plus some modifications:
+
+* FusionDirectory only shows users that have the objectClass inetOrgPerson
+
+* FusionDirectory only recognizes subtrees (or departments in FusionDirectory's view of things) that have the objectClass gosaDepartment.
+  You can hide subtrees from FusionDirectory by not putting this objectClass inside.
+
+The FusionDirectory setup may be used to do these migrations, but it is not meant
+to work in every possible circumstance. Please be carefull when using it on
+productive system.
+
+That should be all. Entries should be visible in FusionDirectory now.
+Be aware that if your naming policy of user cn's differs from the way FusionDirectory handles it, the entries get rewritten to a FusionDirectory style dn.
 
 ## Get help
 
diff --git a/contrib/docs/README.ldap-migration b/contrib/docs/README.ldap-migration
deleted file mode 100644
index 801177188ac359043e85334df96acb9e1a84467b..0000000000000000000000000000000000000000
--- a/contrib/docs/README.ldap-migration
+++ /dev/null
@@ -1,34 +0,0 @@
-LDAP TREE MIGRATION
-===================
-
-To migrate an existing LDAP tree, you've to do all steps from above,
-plus some modifications:
-
-- FusionDirectory only shows users that have the objectClass inetOrgPerson
-
-- FusionDirectory only recognizes subtrees (or departments in FusionDirectory's
-  view of things) that have the objectClass gosaDepartment. You can hide subtrees
-  from FusionDirectory by not putting this objectClass inside.
-
-The FusionDirectory setup may be used to do these migrations, but it is not meant
-to work in every possible circumstance. Please be carefull when using it on
-productive system.
-
-That should be all. Entries should be visible in FusionDirectory now. Be aware that if
-your naming policy of user cn's differs from the way FusionDirectory handles it, the
-entries get rewritten to a FusionDirectory style dn.
-
-Have fun!
-
----
-* Further information
-
-To improve this piece of software, please report all kind of errors using the bug tracker
-on https://gitlab.fusiondirectory.org/
-
-Documentation: http://documentation.fusiondirectory.org/
-Mailinglist:   http://lists.fusiondirectory.org/
-Irc:           #fusiondirectory on freenode
-
----
-The FusionDirectory project <contact@fusiondirectory.org>