From 479554f569abe5dbca980ac930fa1f474ef17c6e Mon Sep 17 00:00:00 2001
From: Tim Graham <timograham@gmail.com>
Date: Tue, 8 Aug 2017 08:55:14 -0400
Subject: [PATCH] [1.11.x] Fixed #28471 -- Clarified that Meta.indexes is
 preferred to index_together.

Backport of d18227e341ed044980d02a1f65f3874166552ded from master
---
 docs/ref/models/options.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/ref/models/options.txt b/docs/ref/models/options.txt
index 0e885dfae6..63a4fc1b79 100644
--- a/docs/ref/models/options.txt
+++ b/docs/ref/models/options.txt
@@ -445,6 +445,12 @@ Django quotes column and table names behind the scenes.
 
 .. attribute:: Options.index_together
 
+    .. admonition:: Use the :attr:`~Options.indexes` option instead.
+
+        The newer :attr:`~Options.indexes` option provides more functionality
+        than ``index_together``. ``index_together`` may be deprecated in the
+        future.
+
     Sets of field names that, taken together, are indexed::
 
         index_together = [