Add sequence diagram to middleware execution order docs

AaronTimony · AaronTimony · commit 1cced5094fa8 · 2026-05-04T15:23:13.000+01:00
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
@@ -88,6 +88,24 @@ This results in the following execution order:
 
 This stacking behavior ensures that middlewares are executed in a predictable and controllable order.
 
+```mermaid
+sequenceDiagram
+    participant Client
+    participant C as Middleware C<br/>(added last &middot; outermost)
+    participant B as Middleware B<br/>(added second)
+    participant A as Middleware A<br/>(added first &middot; innermost)
+    participant App as FastAPI app
+
+    Client ->> C: Request
+    C ->> B: Request
+    B ->> A: Request
+    A ->> App: Request
+    App -->> A: Response
+    A -->> B: Response
+    B -->> C: Response
+    C -->> Client: Response
+```
+
 ## Other middlewares { #other-middlewares }
 
 You can later read more about other middlewares in the [Advanced User Guide: Advanced Middleware](../advanced/middleware.md).
