Skip to content

Commit ad5a890

Browse files
pableujaviereguiluz
authored andcommitted
improve documentation for mailer failover and round-robin transports
1 parent 8bfa680 commit ad5a890

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

mailer.rst

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

193193
Load Balancing
194194
~~~~~~~~~~~~~~
@@ -203,9 +203,12 @@ A round-robin transport is configured with two or more transports and the
203203
204204
MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)"
205205
206-
The mailer will start using the first transport and if it fails, it will retry
207-
the same delivery with the next transports until one of them succeeds (or until
208-
all of them fail).
206+
The round-robin transport starts with a *randomly* selected transport and
207+
then switches to the next available transport for each subsequent email.
208+
209+
As with the failover transport, round-robin retries deliveries until
210+
a transport succeeds (or all fail). In contrast to the failover transport,
211+
it *spreads* the load across all its transports.
209212

210213
Creating & Sending Messages
211214
---------------------------

0 commit comments

Comments
 (0)