From c14c816ea93328776ed1abe0e6edc4ab4b2cef3a Mon Sep 17 00:00:00 2001
From: Headgent Development <rolf@headgent.com>
Date: Tue, 9 Jun 2026 15:10:25 +0200
Subject: [PATCH] docs(seo): sharpen README + composer.json metadata, add
 doc-aware pre-push hook

---
 README.md                 |  4 ++--
 composer.json             | 15 ++++++++++-----
 support/makefile/hooks.mk |  8 ++++++++
 3 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 5247118..d00427d 100644
--- a/README.md
+++ b/README.md
@@ -7,9 +7,9 @@
 [![PSR-12](https://img.shields.io/badge/Code%20Style-PSR--12-blue.svg)](phpcs.xml)
 [![Coverage](https://img.shields.io/badge/Coverage-89.49%25-green.svg)](https://github.com/jardisAdapter/dbConnection)
 
-> Part of the **[Jardis Business Platform](https://jardis.io)** — Enterprise-grade PHP components for Domain-Driven Design
+> Part of **[Jardis](https://jardis.io)** — the Domain-Driven Design platform for PHP. You model your domain; Jardis generates the production-ready hexagonal code (DTOs, Command/Query handlers, repositories, persistence). This package is part of the open-source foundation that generated code runs on.
 
-PDO connection factory with read/write splitting, round-robin load balancing, and automatic health checks. Create typed connections for MySQL, PostgreSQL, or SQLite via `ConnectionFactory`, then compose them into a `ConnectionPool` for replica-aware query routing. Health checks run `SELECT 1` with a configurable TTL cache so failover is fast and non-intrusive.
+A PDO connection pool with read/write splitting for PHP — round-robin load balancing across replicas, and automatic health checks. Create typed connections for MySQL, PostgreSQL, or SQLite via `ConnectionFactory`, then compose them into a `ConnectionPool` for replica-aware query routing. Health checks run `SELECT 1` with a configurable TTL cache so failover is fast and non-intrusive.
 
 ---
 
diff --git a/composer.json b/composer.json
index ae52c51..d753e2b 100644
--- a/composer.json
+++ b/composer.json
@@ -1,7 +1,7 @@
 {
     "name": "jardisadapter/dbconnection",
     "homepage": "https://docs.jardis.io/en/adapter/dbconnection",
-    "description": "PDO connection factory with read/write splitting, round-robin load balancing, and automatic health checks",
+    "description": "PDO connection pool for PHP with read/write splitting, round-robin load balancing across replicas, and automatic health checks — supports MySQL, PostgreSQL, and SQLite; a building block of the open-source foundation that Jardis-generated DDD code runs on",
     "type": "library",
     "license": "MIT",
     "minimum-stability": "stable",
@@ -40,9 +40,14 @@
         "database",
         "connection",
         "pdo",
-        "domain driven design",
-        "JardisAdapter",
-        "Adapter",
-        "headgent"
+        "connection-pool",
+        "read-write-splitting",
+        "mysql",
+        "postgresql",
+        "sqlite",
+        "domain-driven-design",
+        "hexagonal-architecture",
+        "php",
+        "jardis"
     ]
 }
diff --git a/support/makefile/hooks.mk b/support/makefile/hooks.mk
index fc38374..902809e 100644
--- a/support/makefile/hooks.mk
+++ b/support/makefile/hooks.mk
@@ -7,6 +7,14 @@ install-hooks: ## Install git hooks (pre-commit + pre-push)
 	@echo '# Jardis Pre-Push Hook — Quality Gate' >> .git/hooks/pre-push
 	@echo 'set -e' >> .git/hooks/pre-push
 	@echo 'echo "=== Jardis Pre-Push Quality Gate ==="' >> .git/hooks/pre-push
+	@echo '# Doku-Fast-Path: keine *.php geaendert -> PHP-Gates ueberspringen (kein --no-verify, der Hook entscheidet korrekt)' >> .git/hooks/pre-push
+	@echo 'base="$$(git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null || echo origin/develop)"' >> .git/hooks/pre-push
+	@echo 'changed="$$(git diff --name-only "$$base"...HEAD 2>/dev/null)"' >> .git/hooks/pre-push
+	@echo 'if ! echo "$$changed" | grep -q "[.]php$$"; then' >> .git/hooks/pre-push
+	@echo '  echo ">>> Nur Doku/Metadaten geaendert (keine *.php) — phpcs/phpstan/phpunit uebersprungen"' >> .git/hooks/pre-push
+	@echo '  echo "=== Quality Gate (Doku-Fast-Path) bestanden ==="' >> .git/hooks/pre-push
+	@echo '  exit 0' >> .git/hooks/pre-push
+	@echo 'fi' >> .git/hooks/pre-push
 	@echo 'echo ">>> make phpcs"' >> .git/hooks/pre-push
 	@echo 'make phpcs || { echo "PHPCS fehlgeschlagen — Push abgebrochen"; exit 1; }' >> .git/hooks/pre-push
 	@echo 'echo ">>> make phpstan"' >> .git/hooks/pre-push