--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_s2s_smacks_timeout/README.md	Wed Aug 03 03:14:17 2022 +0200
@@ -0,0 +1,20 @@
+# Introduction
+
+This module closes s2s connections when
+[mod_smacks][doc:modules:mod_smacks] reports that a connection has not
+received a timely acknowledgement as requested, indicating that the
+connection is broken or the remote server is not responding.
+
+With the connection closed, the next stanza to be directed to that
+server will trigger Prosody to establish a new connection, instead of
+queueing it on the potentially broken connection.
+
+This should prevent messages from being stuck in a queue for a
+potentially long time before being bounced back to the sender as
+delivery failure reports.
+
+Normally the amount of time it takes for a broken connection to time out
+is determined by TCP.
+
+If this is deemed sensible behavior then it will likely be merged into
+Prosody itself somewhere.