From 55481bcdeef43ef5e345f8ea3bae87f4a8ec7bb8 Mon Sep 17 00:00:00 2001
From: Tim Graham <timograham@gmail.com>
Date: Thu, 28 Jan 2016 12:47:08 -0500
Subject: [PATCH] Fixed #25917 -- Clarified reversibility of RemoveField.

Thanks kaifeldhoff for the draft patch.
---
 docs/ref/migration-operations.txt | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/ref/migration-operations.txt b/docs/ref/migration-operations.txt
index 6255176f80..0e087b02e8 100644
--- a/docs/ref/migration-operations.txt
+++ b/docs/ref/migration-operations.txt
@@ -157,9 +157,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
 ----------