gist.txt

diff --git a/docs/ref/models/meta.txt b/docs/ref/models/meta.txt
index d728714..6526ca3 100644
--- a/docs/ref/models/meta.txt
+++ b/docs/ref/models/meta.txt
@@ -165,7 +165,13 @@ These old APIs can be replicated by either:
   ``_with_model`` variants) the properties of the desired fields.
 
 Assuming you have a model named ``MyModel``, the following substitutions
-can be made to convert your code to the new API:
+can be made to convert your code to the new API.
+
+Although these are being presented as "drop-in" replacements for the old
+API, a simple drop-in replacement probably won't be the best approach in
+practice. Taking the time to refactor any field loops to make better use
+of the new API - and possibly include fields that were previously
+excluded - will almost certainly result in better code.
 
 * ``MyModel._meta.get_field(name)``::
 
@@ -281,8 +287,3 @@ can be made to convert your code to the new API:
   While this isn't 100% backwards compatible, it may be sufficient in many
   situations.
 
-Although these have been presented as "drop-in" replacements for the old API,
-a simple drop-in replacement probably won't be the best approach in practice.
-Taking the time to refactor any field loops to make better use of the new API
-- and possibly include fields that were previously excluded - will almost
-certainly result in better code.