changeset 6764:ea9342f8d46b stable

docs: document X-Kallithea-Notification-Type header
author Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
date Thu, 10 Nov 2016 17:54:05 +0100
parents c25392980f91
children c5e10169d127
files docs/usage/email.rst
diffstat 1 files changed, 13 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/docs/usage/email.rst	Tue Oct 11 17:45:40 2016 +0200
+++ b/docs/usage/email.rst	Thu Nov 10 17:54:05 2016 +0100
@@ -48,6 +48,19 @@
 The subject of these emails can optionally be prefixed with the value of
 ``email_prefix`` in the configuration file.
 
+A Kallithea-specific header indicating the email type will be added to each
+email. This header can be used for email filtering. The header is of the form:
+
+    X-Kallithea-Notification-Type: <type>
+
+where ``<type>`` is one of:
+
+- ``pull_request``: you are invited as reviewer in a pull request
+- ``pull_request_comment``: a comment was given on a pull request
+- ``cs_comment``: a comment was given on a changeset
+- ``registration``: a new user was registered
+- ``message``: another type of email
+
 
 Error emails
 ------------