[1.9.x] Fixed #25917 -- Clarified reversibility of RemoveField.

Thanks kaifeldhoff for the draft patch.

Backport of 55481bcdeef43ef5e345f8ea3bae87f4a8ec7bb8 from master

1 files changed, 5 insertions, 3 deletions

diff --git a/docs/ref/migration-operations.txt b/docs/ref/migration-operations.txt
index de7c6cc9eb..e08984e3a8 100644
--- a/docs/ref/migration-operations.txt
+++ b/docs/ref/migration-operations.txt
@@ -163,9 +163,11 @@ RemoveField
 
 Removes a field from a model.
 
-Bear in mind that when reversed this is actually adding a field to a model;
-if the field is not nullable this may make this operation irreversible (apart
-from any data loss, which of course is irreversible).
+Bear in mind that when reversed, this is actually adding a field to a model.
+The operation is reversible (apart from any data loss, which of course is
+irreversible) if the field is nullable or if it has a default value that can be
+used to populate the recreated column. If the field is not nullable and does
+not have a default value, the operation is irreversible.
 
 AlterField
 ----------