From 1c371d7340db9b4a2918922ee1e09598b4160518 Mon Sep 17 00:00:00 2001
From: steve-chavez <stevechavezast@gmail.com>
Date: Fri, 24 May 2024 17:19:00 -0500
Subject: [PATCH] docs: clarify architecture

---
 docs/explanations/architecture.rst | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/explanations/architecture.rst b/docs/explanations/architecture.rst
index 71af6a0bb..ba5917ed5 100644
--- a/docs/explanations/architecture.rst
+++ b/docs/explanations/architecture.rst
@@ -13,13 +13,20 @@ Code Map
 
 This section talks briefly about various important modules.
 
-The starting points of the program are:
+Main
+----
 
-- `Main.hs <https://github.com/PostgREST/postgrest/blob/main/main/Main.hs>`_
-- `CLI.hs <https://github.com/PostgREST/postgrest/blob/main/src/PostgREST/CLI.hs>`_
-- `App.hs <https://github.com/PostgREST/postgrest/blob/main/src/PostgREST/App.hs>`_
+The starting point of the program is `Main.hs <https://github.com/PostgREST/postgrest/blob/main/main/Main.hs>`_.
 
-``App.hs`` is then in charge of composing the different modules.
+CLI
+---
+
+Main then calls `CLI.hs <https://github.com/PostgREST/postgrest/blob/main/src/PostgREST/CLI.hs>`_, which is in charge of :ref:`cli`.
+
+App
+---
+
+`App.hs <https://github.com/PostgREST/postgrest/blob/main/src/PostgREST/App.hs>`_ is then in charge of composing the different modules.
 
 Auth
 ----