Fixed #17673 -- Forbid field shadowing.

Thanks Anssi Kääriäinen for the suggestion.

1 files changed, 6 insertions, 0 deletions

diff --git a/docs/releases/1.7.txt b/docs/releases/1.7.txt
index b22890c301..bda84e847f 100644
--- a/docs/releases/1.7.txt
+++ b/docs/releases/1.7.txt
@@ -1068,6 +1068,12 @@ Miscellaneous
   which does allow primary keys with value 0. It only forbids *autoincrement*
   primary keys with value 0.
 
+* Shadowing model fields defined in a parent model has been forbidden as this
+  creates amiguity in the expected model behavior. In addition, any clashing
+  fields in the model inheritance hierarchy results in a system check error.
+  For example, if you use multi-inheritance, you need to define custom primary
+  key fields on parent models, otherwise the default ``id`` fields will clash.
+
 .. _deprecated-features-1.7:
 
 Features deprecated in 1.7