diff --git a/README.md b/README.md
index 0e2ab2b..31ed89f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,19 @@
-# docs
+# Wizard4Apps Docs
 
-Wizard4Apps documentation portal content (source of truth for /docs). Edit here — no app deploy needed.
\ No newline at end of file
+This repository is the **source of truth** for the in-app documentation portal
+(`/docs`). Content lives here, not in the application bundle — editing a file in
+this repository publishes the change without an app deploy.
+
+## Sections
+
+- **Elsa** — the workflows engine behind the **Elsa Flows** page (`/flows`).
+
+## Layout
+
+```
+elsa/README.md             -> /docs/elsa
+elsa/getting-started.md    -> /docs/elsa/getting-started
+```
+
+A top-level folder is a section; every other `.md` file inside it is a page.
+`README.md` is the section index page.