diff --git a/developer_manual/app/storage/migrations.rst b/developer_manual/app/storage/migrations.rst
index 542843a74..74910aeea 100644
--- a/developer_manual/app/storage/migrations.rst
+++ b/developer_manual/app/storage/migrations.rst
@@ -1,10 +1,9 @@
+.. _app_db_migrations:
+
 ==========
 Migrations
 ==========
 
-.. app_db_migrations:
-
-
 In the past, apps had a `appinfo/database.xml`-file which holds their database schema
 for installation and update and was a functional method for installing apps which
 had some trouble with upgrading apps (e.g. apps were not able to rename columns
@@ -125,7 +124,8 @@ Migrate from database.xml
 To migrate your app from a `database.xml` file to migrations run:
 
 .. code-block:: bash
-  php ./occ migrations:generate-from-schema <app_id> <version>
+
+   php ./occ migrations:generate-from-schema <app_id> <version>
 
 This will create a new file under `lib/Migration` that results in the
 same database table(s) as your database.xml file.
diff --git a/developer_manual/app/storage/schema.rst b/developer_manual/app/storage/schema.rst
index 15d0fd62a..73141eeb6 100644
--- a/developer_manual/app/storage/schema.rst
+++ b/developer_manual/app/storage/schema.rst
@@ -2,8 +2,8 @@
 Database schema (deprecated)
 ============================
 
-.. note:: Using the database.xml schema file is deprecated. You should migrate
-to using :ref:`Databse Migrations app_db_migrations`.
+.. warning:: Using the database.xml schema file is deprecated.
+             You should migrate to using :ref:`Database Migrations <app_db_migrations>`.
 
 .. sectionauthor:: Bernhard Posselt <dev@bernhard-posselt.com>