From 6b54504e667da3f6bc53b887ffd7e8cc113a94b1 Mon Sep 17 00:00:00 2001
From: Claude Paroz <claude@2xlibre.net>
Date: Thu, 1 Sep 2016 15:59:33 +0200
Subject: [PATCH] Refs #27162 -- Complemented docs related to CreateExtension

Thanks Tim Graham for the review.
---
 docs/ref/contrib/gis/install/postgis.txt | 12 +++++++++++-
 docs/ref/databases.txt                   |  7 +++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/docs/ref/contrib/gis/install/postgis.txt b/docs/ref/contrib/gis/install/postgis.txt
index 646e2aae2b4..8416f790c88 100644
--- a/docs/ref/contrib/gis/install/postgis.txt
+++ b/docs/ref/contrib/gis/install/postgis.txt
@@ -65,7 +65,17 @@ functionality::
 
 The database user must be a superuser in order to run
 ``CREATE EXTENSION postgis;``. The command is run during the :djadmin:`migrate`
-process.
+process. An alternative is to use a migration operation in your project::
+
+    from django.contrib.postgresql.operations import CreateExtension
+    from django.db import migrations
+
+    class Migration(migrations.Migration):
+
+        operations = [
+            CreateExtension('postgis'),
+            ...
+        ]
 
 GeoDjango does not currently leverage any `PostGIS topology functionality`__.
 If you plan to use those features at some point, you can also install the
diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt
index 257324330d8..6d705beb661 100644
--- a/docs/ref/databases.txt
+++ b/docs/ref/databases.txt
@@ -164,6 +164,13 @@ lookups that use the ``LIKE`` operator in their SQL, as is done with the
 
 .. _PostgreSQL operator class: http://www.postgresql.org/docs/current/static/indexes-opclass.html
 
+Migration operation for adding extensions
+-----------------------------------------
+
+If you need to add a PostgreSQL extension (like ``hstore``, ``postgis``, etc.)
+using a migration, use the
+:class:`~django.contrib.postgres.operations.CreateExtension` operation.
+
 Test database templates
 -----------------------