From d1c11aff89261bd4a7d26f436fb8084eb6b9262f Mon Sep 17 00:00:00 2001
From: SemianiakaVY <admin@wiz4chat.com>
Date: Fri, 25 Sep 2026 10:35:22 +0000
Subject: [PATCH] docs: portal readme

---
 README.md | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

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.