Docs: Django integration.

docs/django.rst

@@ -0,0 +1,25 @@
+Django integration
+==================
+
+If you are using the SDK in a `Django`_ project, you can add ``kabelwerk`` to
+your ``INSTALLED_APPS`` — and the relevant ``KABELWERK_*`` variables in your
+Django settings will be picked up by the SDK.
+
+.. code:: python
+
+    # add 'kabelwerk' to your INSTALLED_APPS
+    INSTALLED_APPS = [
+        # ...
+        'kabelwerk',
+    ]
+
+    # configure the Kabelwerk SDK
+    KABELWERK_URL = 'example.kabelwerk.io'
+    KABELWERK_API_TOKEN = '<secret>'
+
+This way you can keep the Kabelwerk SDK config together with the rest of your
+settings.
+
+
+.. _`Django`: https://www.djangoproject.com/
+.. _`INSTALLED_APPS`: https://docs.djangoproject.com/en/4.2/ref/settings/#installed-apps

docs/index.rst

@@ -42,6 +42,9 @@ You can set this in the SDK's config at runtime:
 Alternatively, you can set the environment variables ``KABELWERK_URL`` and
 ``KABELWERK_API_TOKEN`` — these will be read when you first import the SDK.
 
+If you have a Django project, you can also configure the SDK in your settings.
+Check the `Django integration`_ page for more details.
+
 
 Reference
 ---------
@@ -51,8 +54,10 @@ Reference
 
     api
     exceptions
+    django
 
 
 .. _`Kabelwerk`: https://kabelwerk.io
 .. _`Cheese Shop`: https://pypi.org/project/kabelwerk/
 .. _`CHANGELOG.rst`: https://github.com/kabelwerk/sdk-python/blob/master/CHANGELOG.rst
+.. _`Django integration`: django.html