From 514a911529073d45a54d62e2d71cb2f280f0373a Mon Sep 17 00:00:00 2001
From: missytake <missytake@systemli.org>
Date: Thu, 13 Nov 2025 21:02:19 +0100
Subject: [PATCH] docs: document which services are involved in delivering an
 internal msg (#678)

* doc: add diagram for internal message

* doc: apostrophe for clarity
---
 doc/source/overview.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/source/overview.rst b/doc/source/overview.rst
index 4b4a044f..f73f0723 100644
--- a/doc/source/overview.rst
+++ b/doc/source/overview.rst
@@ -174,6 +174,24 @@ Component dependency diagram
         style nginx-external fill:#fc9;
         style nginx-right fill:#fc9;
 
+Message between users on the same relay
+---------------------------------------
+
+.. mermaid::
+    :caption: This diagram shows the path a non-federated message takes.
+
+    graph LR;
+        sender --> |465|smtps/smtpd;
+        sender --> |587|submission/smtpd;
+        smtps/smtpd --> |10080|filtermail;
+        submission/smtpd --> |10080|filtermail;
+        filtermail --> |10025|smtpd_reinject;
+        smtpd_reinject --> cleanup;
+        cleanup --> qmgr;
+        qmgr --> smtpd_accepts_message;
+        qmgr --> |lmtp|dovecot;
+        dovecot --> recipient;
+        dovecot --> sender's_other_devices;
 
 Operational details of a chatmail relay
 ----------------------------------------