Skip to content

Commit 771ec78

Browse files
committed
improve documentation for mailer failover and round-robin transports
1 parent 57b7b39 commit 771ec78

File tree

1 file changed

+5
-6
lines changed

1 file changed

+5
-6
lines changed

mailer.rst

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -210,9 +210,9 @@ A failover transport is configured with two or more transports and the
210210
211211
MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)"
212212
213-
The mailer will start using the first transport. If the sending fails, the
214-
mailer won't retry it with the other transports, but it will switch to the next
215-
transport automatically for the following deliveries.
213+
The mailer will start using the first transport and if it fails, it
214+
will retry the same delivery with the next transports until one of them succeeds
215+
(or until all of them fail).
216216

217217
Load Balancing
218218
~~~~~~~~~~~~~~
@@ -227,9 +227,8 @@ A round-robin transport is configured with two or more transports and the
227227
228228
MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)"
229229
230-
The mailer will start using a randomly selected transport and if it fails, it
231-
will retry the same delivery with the next transports until one of them succeeds
232-
(or until all of them fail).
230+
The round-robin transport is similar to the failover transport (see above), but
231+
it starts with a *randomly* selected transport instead of the first in the list.
233232

234233
.. versionadded:: 5.1
235234

0 commit comments

Comments
 (0)