diff --git a/README.md b/README.md
index 377bd1d..1eb7a76 100644
--- a/README.md
+++ b/README.md
@@ -75,6 +75,56 @@ After install:
 
 ---
 
+## ✅ What the installers do
+
+### Linux / WSL
+
+- Installs the prompt module to `/etc/profile.d/ps1.sh`
+- Installs the banner module to `/etc/profile.d/banner.sh`
+- Sources both from `/etc/bash.bashrc`
+- Installs `landscape-common`, `figlet`, and `lolcat` if missing
+- Prompts for the global punchline used by the banner
+
+### macOS
+
+- Copies `ps1/ps1.sh` to `~/.config/ps1/ps1.sh`
+- Adds a source block in `~/.bashrc` and `~/.bash_profile`
+
+---
+
+## PS1 module (when it runs)
+
+The prompt is loaded automatically by the installer:
+
+- Linux/WSL: sourced from `/etc/bash.bashrc` (global)
+- macOS: sourced from `~/.bashrc` and `~/.bash_profile` (per-user)
+
+You normally do not need to run `ps1.sh` manually.
+
+---
+
+## Banner (hostname + punchline + sysinfo)
+
+På Linux/WSL lastes også et banner ved login:
+
+- `figlet $(hostname) -c | lolcat`
+- `figlet -f digital "<punchline>" -c | lolcat`
+- `landscape-sysinfo | lolcat`
+
+### Punchline (global)
+
+Banneret leser punchline fra:
+
+- `/etc/ps1-punchline`
+
+Install-scriptet spør etter punchline og lagrer den i filen. Du kan også sette den manuelt:
+
+```bash
+echo "Din punchline" | sudo tee /etc/ps1-punchline >/dev/null
+```
+
+---
+
 ## 🧠 Features
 
 - **Clean, modern powerline-style prompt**
@@ -101,28 +151,6 @@ dotfiles/
 └── README.md
 ```
 
----
-
-## Banner (hostname + punchline + sysinfo)
-
-På Linux/WSL lastes også et banner ved login:
-
-- `figlet $(hostname) -c | lolcat`
-- `figlet -f digital "<punchline>" -c | lolcat`
-- `landscape-sysinfo | lolcat`
-
-### Punchline (global)
-
-Banneret leser punchline fra:
-
-- `/etc/ps1-punchline`
-
-Install-scriptet spør etter punchline og lagrer den i filen. Du kan også sette den manuelt:
-
-```bash
-echo "Din punchline" | sudo tee /etc/ps1-punchline >/dev/null
-```
-
 ## ⚙️ Overrides (Optional)
 
 Sometimes autodetection doesn’t work (e.g., on macOS without fontconfig):