From 509b2e4f3eccf8879c11d58157dad9f40ea789d1 Mon Sep 17 00:00:00 2001
From: Tobias Kunze <rixx@cutebit.de>
Date: Wed, 10 Aug 2016 22:17:16 +0200
Subject: [PATCH] Document mail testing setup for devs (#157)

---
 doc/development/setup.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/development/setup.rst b/doc/development/setup.rst
index 28495cf61b..50a7aa5b5a 100644
--- a/doc/development/setup.rst
+++ b/doc/development/setup.rst
@@ -102,6 +102,19 @@ for example::
     flake8 --ignore=E123,E128,F403,F401,N802,W503 .
 
 
+Working with mails
+^^^^^^^^^^^^^^^^^^
+If you want to test anything regarding emails in your development setup, we recommend
+starting Python's debugging SMTP server in a separate shell and configuring pretix to use it.
+Every email will then be printed to the debugging SMTP server's stdout.
+
+Add this to your ``src/pretix.cfg``::
+
+    [mail]
+    port = 1025
+
+Then execute ``python -m smtpd -n -c DebuggingServer localhost:1025``.
+
 
 Working with the documentation
 ------------------------------