docs: remove obsolete config.example.php and update all documentation

Removed:
- examples/config.example.php (obsolete multi-dialect format)
  - Used old array format with keys: ['mysql' => [...], 'pgsql' => [...]]
  - No longer compatible with current architecture
  - All actual configs already in repo

Updated Documentation:
- README.md: Removed config creation instructions (configs already exist)
- examples/README.md: Updated status table - all configs included
- scripts/test-examples.sh: Updated tip message (no config.example.php reference)

Current Architecture (CORRECT):
✅ examples/config.sqlite.php - ready to use (:memory:)
✅ examples/config.mysql.php - update credentials and run
✅ examples/config.pgsql.php - update credentials and run

.gitignore Update:
- Removed examples/config.php from ignore (not used anymore)
- Added comment: config.*.php files tracked in repo with default credentials
- Users just update credentials, no copying needed

User Experience:
Before: "Copy config.example.php to config.php, then edit"
After:  "Edit config.mysql.php with your credentials"

Much simpler and less confusing!

Testing:
✅ All 21 examples still pass on all 3 dialects (63/63)

Author: tommyknocker

.gitignore

@@ -10,8 +10,8 @@ coverage-*.xml
 coverage/
 .coverage
 
-# Examples
-examples/config.php
+# Examples - temporary files only
+# Note: config.*.php files are tracked in repo with default credentials
 examples/**/*.db
 examples/**/*.sqlite
 examples/**/*.sql

README.md

@@ -124,40 +124,13 @@ Each example is self-contained with setup instructions. See [`examples/README.md
 ```bash
 cd examples
 
-# SQLite is already configured (examples/config.sqlite.php)
+# SQLite (ready to use, no setup required)
 php 01-basic/02-simple-crud.php
 
-# For MySQL - create config.mysql.php based on config.example.php
-cat > config.mysql.php << 'EOF'
-<?php
-return [
-    'driver' => 'mysql',
-    'host' => 'localhost',
-    'port' => 3306,
-    'username' => 'your_user',
-    'password' => 'your_pass',
-    'dbname' => 'your_db',
-    'charset' => 'utf8mb4'
-];
-EOF
-
-# Run with MySQL
+# MySQL (update config.mysql.php with your credentials)
 PDODB_DRIVER=mysql php 01-basic/02-simple-crud.php
 
-# For PostgreSQL - create config.pgsql.php
-cat > config.pgsql.php << 'EOF'
-<?php
-return [
-    'driver' => 'pgsql',
-    'host' => 'localhost',
-    'port' => 5432,
-    'username' => 'your_user',
-    'password' => 'your_pass',
-    'dbname' => 'your_db'
-];
-EOF
-
-# Run with PostgreSQL
+# PostgreSQL (update config.pgsql.php with your credentials)
 PDODB_DRIVER=pgsql php 01-basic/02-simple-crud.php
 
 # Test all examples on all available databases

examples/README.md

@@ -12,38 +12,19 @@ php 01-basic/02-simple-crud.php
 
 ### Option 2: MySQL
 ```bash
-# Create MySQL configuration
-cat > config.mysql.php << 'EOF'
-<?php
-return [
-    'driver' => 'mysql',
-    'host' => 'localhost',
-    'port' => 3306,
-    'username' => 'your_user',
-    'password' => 'your_pass',
-    'dbname' => 'your_db',
-    'charset' => 'utf8mb4'
-];
-EOF
+# Edit config.mysql.php with your credentials
+# File already exists in examples/ directory
+nano config.mysql.php
 
 # Run with MySQL
 PDODB_DRIVER=mysql php 01-basic/02-simple-crud.php
 ```
 
 ### Option 3: PostgreSQL
 ```bash
-# Create PostgreSQL configuration
-cat > config.pgsql.php << 'EOF'
-<?php
-return [
-    'driver' => 'pgsql',
-    'host' => 'localhost',
-    'port' => 5432,
-    'username' => 'your_user',
-    'password' => 'your_pass',
-    'dbname' => 'your_db'
-];
-EOF
+# Edit config.pgsql.php with your credentials
+# File already exists in examples/ directory
+nano config.pgsql.php
 
 # Run with PostgreSQL
 PDODB_DRIVER=pgsql php 01-basic/02-simple-crud.php
@@ -64,9 +45,9 @@ PDOdb examples use **separate config files per database**:
 
 | File | Database | Status |
 |------|----------|--------|
-| `config.sqlite.php` | SQLite | ✅ Included in repo |
-| `config.mysql.php` | MySQL | Create from `config.example.php` |
-| `config.pgsql.php` | PostgreSQL | Create from `config.example.php` |
+| `config.sqlite.php` | SQLite | ✅ Included, ready to use (`:memory:`) |
+| `config.mysql.php` | MySQL | ✅ Included, update credentials |
+| `config.pgsql.php` | PostgreSQL | ✅ Included, update credentials |
 
 **Environment variable `PDODB_DRIVER`** controls which config to use:
 - `sqlite` (default) - loads `config.sqlite.php`

examples/config.example.php

@@ -213,7 +213,7 @@ else
             echo "  • $db"
         done
         echo ""
-        echo "   See examples/config.example.php for reference"
+        echo "   Config files included - just update credentials in examples/config.*.php"
     fi
 
     exit 0