From df4a07982f553cb8dbbe7e66c47fd48cdd0a3486 Mon Sep 17 00:00:00 2001
From: Paul Hallett <paul.hallett@babylonhealth.com>
Date: Tue, 7 May 2019 20:22:08 +0100
Subject: [PATCH] Add documentation for settings

---
 docs/index.rst    |   2 +-
 docs/settings.rst | 103 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 104 insertions(+), 1 deletion(-)
 create mode 100644 docs/settings.rst

diff --git a/docs/index.rst b/docs/index.rst
index c7820cf..602f8dd 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -29,6 +29,6 @@ For more advanced use, check out the Relay tutorial.
    filtering
    authorization
    debug
-   rest-framework
    introspection
    testing
+   settings
diff --git a/docs/settings.rst b/docs/settings.rst
new file mode 100644
index 0000000..bd09886
--- /dev/null
+++ b/docs/settings.rst
@@ -0,0 +1,103 @@
+Settings
+========
+
+Graphene-Django can be customised using settings. This page explains each setting and their defaults.
+
+Usage
+-----
+
+Add settings to your Django project by creating a Dictonary with name ``GRAPHENE`` in the project's ``settings.py``:
+
+.. code:: python
+
+    GRAPHENE = {
+        ...
+    }
+
+
+``SCHEMA``
+----------
+
+The location of the top-level ``Schema`` class.
+
+Default: ``None``
+
+.. code:: python
+
+    GRAPHENE = {
+        'SCHEMA': 'path.to.schema.schema',
+    }
+
+
+``SCHEMA_OUTPUT``
+----------
+
+The name of the file where the GraphQL schema output will go.
+
+Default: ``schema.json``
+
+.. code:: python
+
+    GRAPHENE = {
+        'SCHEMA_OUTPUT': 'schema.json',
+    }
+
+
+``SCHEMA_INDENT``
+----------
+
+The indentation level of the schema output.
+
+Default: ``2``
+
+.. code:: python
+
+    GRAPHENE = {
+        'SCHEMA_INDENT': 2,
+    }
+
+
+``MIDDLEWARE``
+----------
+
+A tuple of middleware that will be executed for each GraphQL query.
+
+See the `middleware documentation <https://docs.graphene-python.org/en/latest/execution/middleware/>`__ for more information.
+
+Default: ``()``
+
+.. code:: python
+
+    GRAPHENE = {
+        'MIDDLEWARE': (
+            'path.to.my.middleware.class',
+        ),
+    }
+
+
+``RELAY_CONNECTION_ENFORCE_FIRST_OR_LAST``
+----------
+
+Enforces relay queries to have the ``first`` or ``last`` argument.
+
+Default: ``False``
+
+.. code:: python
+
+    GRAPHENE = {
+        'RELAY_CONNECTION_ENFORCE_FIRST_OR_LAST': False,
+    }
+
+
+``RELAY_CONNECTION_MAX_LIMIT``
+----------
+
+The maximum size of objects that can be requested through a relay connection.
+
+Default: ``100``
+
+.. code:: python
+
+    GRAPHENE = {
+        'RELAY_CONNECTION_MAX_LIMIT': 100,
+    }
\ No newline at end of file