diff --git a/CHANGELOG.md b/CHANGELOG.md
index 21bd4e2..426e092 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,7 @@
 ## 2.4.0
 
-* Add possibility to lint newly generated migrations through the `makemigrations` command
+* Add possibility to lint newly generated migrations through the `makemigrations` command.
+You can activate it through the `--lint` command option, or by default with the `MIGRATION_LINTER_OVERRIDE_MAKEMIGRATIONS = True`  Django settings.
 
 ## 2.3.0
 
diff --git a/README.md b/README.md
index 579e151..2b04d40 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,12 @@ Migrations for 'app_correct':
 Linting for 'app_correct':
 (app_correct, 0003_a_column)... ERR
         NOT NULL constraint on columns
+
+The migration linter detected that this migration is not be backward compatible.
+- If you keep the migration, you will want to fix the issue or ignore the migration.
+- By default, the newly created migration file will be deleted.
+Do you want to keep the migration? [y/N]
+[...]
 Deleted tests/test_project/app_correct/migrations/0003_a_column.py
 ```