diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 2c52315c..69fe0fc2 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -6,7 +6,10 @@ This document describes changes between each past release.
 3.1 (unreleased)
 ----------------
 
-- Nothing changed yet.
+Added
+=====
+
+- Document database migrations (#390)
 
 
 3.0 (2018-11-25)
@@ -41,7 +44,6 @@ Added
 - Improve settings documentation styling (#251)
 - Add a ihatemoney delete-project command to delete a project (#375)
 - Add nice 404 error pages (#379)
-- Document database migrations (#390)
 
 Changed
 =======
diff --git a/docs/contributing.rst b/docs/contributing.rst
index 4b9e58b4..bcb3f162 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -55,7 +55,8 @@ Then run the following command to create a new database revision file::
   make create-database-revision
 
 If your changes are simple enough, the generated script will be populated with
-the necessary migrations steps.
+the necessary migrations steps. You can edit the generated script. eg: to add data migrations.
+
 For complex migrations, it is recommended to start from an empty revision file which can be created
 with the following command::