site fix

Author: bigBrodyG

README.md

@@ -14,3 +14,112 @@
 **[View the interactive showcase website →](https://bigBrodyG.github.io/JavaProjects/)**
 
 All projects are automatically compiled and run with each commit. The website displays source code, build status, and program output.
+
+---
+
+## 🚀 Automatic Documentation Generator
+
+This repository includes an **automatic documentation generator** that scans all Java projects and creates a beautiful interactive showcase website.
+
+### ✨ Features
+
+- 🔍 **Auto-discovery**: Automatically finds all Java projects in the workspace
+- 🏗️ **Auto-compilation**: Compiles and runs each project to capture output
+- 📝 **HTML Generation**: Creates individual interactive pages for each project
+- 🎨 **Beautiful UI**: Modern dark theme with syntax highlighting
+- ▶️ **Run in Browser**: Execute code with animated output display
+- 📊 **Index Page**: Auto-generated overview of all projects
+
+### 🎯 How It Works
+
+#### When you create a new Java project:
+
+1. Create a new directory (e.g., `MyNewProject/`)
+2. Add the standard structure:
+   ```
+   MyNewProject/
+   ├── src/
+   │   └── MyNewProject.java  (with main method)
+   ├── bin/
+   └── lib/
+   ```
+
+3. Run the generator:
+   ```bash
+   ./generate-docs.py
+   ```
+   or
+   ```bash
+   python3 generate-docs.py
+   ```
+
+4. **That's it!** Your project is automatically:
+   - ✅ Compiled and tested
+   - ✅ Added to the website with its own page
+   - ✅ Listed on the index page
+   - ✅ Output captured and displayed
+
+### 📁 Project Structure
+
+Each Java project should follow this structure:
+
+```
+ProjectName/
+├── src/              # Source files
+│   └── *.java        # Your Java files (one must have main method)
+├── bin/              # Compiled classes (auto-generated)
+├── lib/              # External libraries (optional)
+└── README.md         # Project documentation (optional)
+```
+
+### 🎨 Project Types
+
+The generator automatically categorizes projects:
+
+- **📚 Teoria (Theory)**: Basic concepts, classes (e.g., Cerchio, Punto, Rettangolo, Libro)
+- **🔬 Laboratorio (Lab)**: Practical exercises (e.g., mergeArray, vocalcount, OggettoCD)
+
+### 🔧 Manual Customization
+
+If you want to customize project descriptions or types, edit the script:
+
+```python
+# In generate-docs.py
+
+def generate_project_description(project: Dict) -> str:
+    descriptions = {
+        'yourproject': 'Your custom description here',
+        # Add more...
+    }
+```
+
+### 📦 Generated Files
+
+After running the generator, you'll find in `docs/`:
+
+```
+docs/
+├── index.html                 # Main showcase page
+├── projectname.html          # Individual project page
+├── projectname-output.txt    # Captured output
+└── ...
+```
+
+### 🌐 View the Showcase
+
+Open `docs/index.html` in your browser to see all your projects!
+
+### 🛠️ Requirements
+
+- Python 3.6+
+- Java JDK (javac and java commands available)
+- No additional Python packages required (uses only standard library)
+
+### 💡 Quick Start
+
+1. Create a new Java project in the workspace
+2. Run `./generate-docs.py`
+3. Open `docs/index.html` in browser
+4. Enjoy! 🎉
+
+---