cleanup structure

examples/README.md

@@ -0,0 +1,36 @@
+# Luash Examples
+
+This directory contains examples demonstrating Luash features, organized in a logical learning order:
+
+## 📚 Learning Path
+
+1. **[01_basic_features.luash](01_basic_features.luash)** - Core Luash features (env vars, commands, strings)
+2. **[02_quick_comparison.luash](02_quick_comparison.luash)** - Side-by-side comparison with Bash
+3. **[03_interpolation.luash](03_interpolation.luash)** - Variable interpolation in shell commands
+4. **[04_system_admin.luash](04_system_admin.luash)** - System administration tasks
+5. **[05_development.luash](05_development.luash)** - Development workflows
+6. **[06_data_processing.luash](06_data_processing.luash)** - Data analysis and processing
+7. **[07_interactive_demo.luash](07_interactive_demo.luash)** - Building interactive applications
+8. **[08_repl_guide.luash](08_repl_guide.luash)** - Interactive shell usage guide
+9. **[09_showcase.luash](09_showcase.luash)** - Complete feature showcase
+
+## 🚀 Quick Start
+
+```bash
+# Run individual examples
+../luash 01_basic_features.luash
+
+# Run the showcase (best overview)
+../luash 09_showcase.luash
+
+# Try the interactive shell
+../luash -i
+```
+
+## 📝 Example Categories
+
+- **Basics**: Examples 1-3 cover fundamental syntax and features
+- **Use Cases**: Examples 4-6 show practical applications
+- **Advanced**: Examples 7-9 cover interactive features and comprehensive demos
+
+Each example is self-contained and includes explanatory comments.