[WIP] Generate Comprehensive Architecture Documentation with Mermaid Diagrams

README.md

@@ -1,6 +1,16 @@
 # plingua
 The P-Lingua language for Membrane Computing
 
+P-Lingua is a comprehensive framework for membrane computing that provides a complete ecosystem for defining, parsing, simulating, and generating code for P-systems (membrane systems).
+
+## 📚 Documentation
+
+### [Comprehensive Architecture Documentation](docs/README.md)
+Detailed architectural insights with Mermaid diagrams covering:
+- **[System Architecture](docs/ARCHITECTURE.md)**: High-level design patterns and data flows
+- **[Component Deep Dive](docs/COMPONENTS.md)**: Internal architecture of parser, simulator, and generator
+- **[Usage Examples](docs/EXAMPLES.md)**: Practical demonstrations and integration guides
+
 ## Dependencies 
 
 * Linux OS (tested on Ubuntu 16.04 and Ubuntu 18.04)
@@ -19,3 +29,25 @@ sudo apt-get install build-essential flex bison libboost-filesystem-dev libboost
 * make simulator
 * sudo make install
 
+## Architecture Overview
+
+```mermaid
+graph TD
+    A[P-Lingua Source] --> B[Parser]
+    B --> C[P-System Model]
+    C --> D[Simulator]
+    C --> E[Code Generator]
+    D --> F[Results]
+    E --> G[Generated Code]
+
+    style A fill:#e3f2fd
+    style C fill:#f3e5f5
+    style F fill:#e8f5e8
+    style G fill:#fff3e0
+```
+
+The framework consists of three main components:
+- **Parser**: Transforms P-Lingua source into executable models
+- **Simulator**: Executes membrane computing simulations
+- **Generator**: Produces optimized C++ implementations
+