From 0f5ed2416cb3e0e78866ef3d800ab67ca18c75f0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 18 Feb 2026 09:01:48 +0000
Subject: [PATCH] Add documentation index section to README

Co-authored-by: squassina <8495707+squassina@users.noreply.github.com>
---
 README.md | 42 +++++++++++++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 27a4ea49..d0445505 100644
--- a/README.md
+++ b/README.md
@@ -594,11 +594,47 @@ git clone https://github.com/DreamMaoMao/mango-config.git ~/.config/mango
 ```
 
 
-## Config Documentation
+## Documentation
 
-Refer to the repo wiki [wiki](https://github.com/DreamMaoMao/mango/wiki/)
+MangoWC comes with comprehensive documentation to help you get started and master the compositor:
 
-or the website docs [docs](https://mangowc.vercel.app/docs)
+### 📚 Documentation Files
+
+- **[USAGE.md](USAGE.md)** - Practical guide for day-to-day usage
+  - Common workflows and usage patterns
+  - Layout explanations with diagrams
+  - Scratchpad and overview mode guides
+  - Multi-monitor workflows
+  - Customization tips and examples
+
+- **[COMMANDS.md](COMMANDS.md)** - Complete command reference
+  - All available commands with descriptions
+  - Parameter documentation
+  - Keybinding examples
+  - IPC/mmsg usage and scripting examples
+
+- **[config.conf](config.conf)** - Annotated configuration file
+  - All settings explained with inline comments
+  - Example configurations
+  - Default keybindings
+
+### 🌐 Online Resources
+
+- **[Wiki](https://github.com/DreamMaoMao/mango/wiki/)** - Comprehensive online documentation
+- **[Website](https://mangowc.vercel.app/docs)** - Web-based documentation
+- **[Discord](https://discord.gg/CPjbDxesh5)** - Community support and discussions
+
+### 📖 Quick Links by Topic
+
+- **Getting Started:** See [Quick Start Guide](#quick-start-guide) above
+- **Understanding Concepts:** [Key Concepts](#key-concepts) section above
+- **Daily Usage:** [USAGE.md](USAGE.md) for workflows and patterns
+- **Command Reference:** [COMMANDS.md](COMMANDS.md) for all commands
+- **Configuration:** [config.conf](config.conf) with inline documentation
+- **Troubleshooting:** [Troubleshooting](#troubleshooting) section above
+- **IPC/Scripting:** [IPC Control with mmsg](#ipc-control-with-mmsg) section above
+
+---
 
 # NixOS + Home-manager