Add note on what to do in case of SMTPRecipientsRefused (#558)

* Fix formatting Signed-off-by: F.N. Claessen <felix@seita.nl> * Add note explaining SMTPRecipientsRefused Signed-off-by: F.N. Claessen <felix@seita.nl> * Changelog entry Signed-off-by: F.N. Claessen <felix@seita.nl> Signed-off-by: F.N. Claessen <felix@seita.nl>
FlexMeasures · Dec 19, 2022 · 1e25d1b · 1e25d1b
1 parent 4aff175
commit 1e25d1b
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 2 deletions.
diff --git a/documentation/changelog.rst b/documentation/changelog.rst
@@ -45,6 +45,7 @@ Infrastructure / Support
 * Scheduling test for maximizing self-consumption, and improved time series db queries for fixed tariffs (and other long-term constants) [see `PR #532 <http://www.github.com/FlexMeasures/flexmeasures/pull/532>`_]
 * Clean up table formatting for ``flexmeasures show`` CLI commands [see `PR #540 <http://www.github.com/FlexMeasures/flexmeasures/pull/540>`_]
 * Add  ``"Deprecation"`` and ``"Sunset"`` response headers for API users of deprecated API versions, and log warnings for FlexMeasures hosts when users still use them [see `PR #554 <http://www.github.com/FlexMeasures/flexmeasures/pull/554>`_]
+* Explain how to avoid potential ``SMTPRecipientsRefused`` errors when using FlexMeasures in combination with a mail server [see `PR #558 <http://www.github.com/FlexMeasures/flexmeasures/pull/558>`_]
 
 .. warning:: The CLI command ``flexmeasures monitor tasks`` has been renamed to ``flexmeasures monitor last-run``. The old name will stop working in version 0.13.
 

diff --git a/documentation/configuration.rst b/documentation/configuration.rst
@@ -122,7 +122,7 @@ FLEXMEASURES_MENU_LOGO_PATH
 A URL path to identify an image being used as logo in the upper left corner (replacing some generic text made from platform name and the page title).
 The path can be a complete URL or a relative from the app root. 
 
-Default: ""
+Default: ``""``
 
 
 .. _extra-css-config:
@@ -135,7 +135,7 @@ The path can be a complete URL or a relative from the app root.
 
 .. note:: You can also add extra styles for plugins with the usual Blueprint method. That is more elegant but only applies to the Blueprint's views.
 
-Default: ""
+Default: ``""``
 
 
 FLEXMEASURES_ROOT_VIEW
@@ -440,6 +440,9 @@ MAIL_DEFAULT_SENDER (*)
 
 Tuple of shown name of sender and their email address.
 
+.. note:: Some recipient mail servers will refuse emails for which the shown email address (set under ``MAIL_DEFAULT_SENDER``) differs from the sender's real email address (registered to ``MAIL_USERNAME``).
+         Match them to avoid ``SMTPRecipientsRefused`` errors.
+
 Default:
 
 .. code-block:: python