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

---
 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 e6e9348052..bf8cf10c33 100644
--- a/docs/ref/models/options.txt
+++ b/docs/ref/models/options.txt
@@ -417,6 +417,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 = [