diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index d5856a2c68..49a3982239 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -298,6 +298,9 @@ details on these changes.
 
 * The ``django.contrib.contenttypes.generic`` module will be removed.
 
+* Private APIs ``django.db.models.sql.where.WhereNode.make_atom()`` and
+  ``django.db.models.sql.where.Constraint`` will be removed.
+
 .. _deprecation-removed-in-1.8:
 
 1.8
diff --git a/docs/releases/1.7.txt b/docs/releases/1.7.txt
index aa2453d0ff..09b967dfe5 100644
--- a/docs/releases/1.7.txt
+++ b/docs/releases/1.7.txt
@@ -1779,6 +1779,13 @@ Django 1.9.
 Django no longer uses this functional internally. Even though it's a private
 API, it'll go through the normal deprecation cycle.
 
+Private Query Lookup APIs
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Private APIs ``django.db.models.sql.where.WhereNode.make_atom()`` and
+``django.db.models.sql.where.Constraint`` are deprecated in favor of the new
+:doc:`custom lookups API </ref/models/lookups>`.
+
 .. removed-features-1.7:
 
 Features removed in 1.7