docs: revamp adapter examples, consolidate payment gateway docs, and add mkdocs nav updates

- Rename parsian_payment.md to payment_gateways.md with unified content
- Refactor and trim examples for redis, temporal, elasticsearch, postgres adapters
- Add hide/copy code block buttons across all example and reference pages
- Expand scylladb, starrocks, kafka, keycloak, minio, sqlite examples
- Update mkdocs.yml navigation to reflect new structure

Author: HosseinNejatiJavaremi

docs/api_reference/adapters/base.md

@@ -1,3 +1,8 @@
+---
+title: Base SQLAlchemy
+description: API reference for the base SQLAlchemy adapter ports, session managers, and registry.
+---
+
 # Base SQLAlchemy
 
 The `base/sqlalchemy` subpackage provides the foundational SQLAlchemy components shared across all relational database adapters, including the abstract port interface, session managers, and session manager registries.
@@ -8,7 +13,6 @@ Abstract port interface defining the contract all SQLAlchemy-based adapters must
 
 ::: archipy.adapters.base.sqlalchemy.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,7 +22,6 @@ Abstract interface for SQLAlchemy session managers, decoupling session lifecycle
 
 ::: archipy.adapters.base.sqlalchemy.session_manager_ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -28,7 +31,6 @@ Registry for tracking and resolving active session manager instances.
 
 ::: archipy.adapters.base.sqlalchemy.session_manager_registry
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -38,7 +40,6 @@ Concrete session manager implementations that handle SQLAlchemy session creation
 
 ::: archipy.adapters.base.sqlalchemy.session_managers
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -48,6 +49,5 @@ The base SQLAlchemy adapter implements generic CRUD operations that concrete dat
 
 ::: archipy.adapters.base.sqlalchemy.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/elasticsearch.md

@@ -1,3 +1,8 @@
+---
+title: Elasticsearch
+description: API reference for the Elasticsearch adapter ports, adapters, and mocks.
+---
+
 # Elasticsearch
 
 The `elasticsearch` adapter provides integration with Elasticsearch for full-text search, document indexing, and analytics queries.
@@ -8,7 +13,6 @@ Abstract port interface defining the Elasticsearch adapter contract.
 
 ::: archipy.adapters.elasticsearch.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,6 +22,5 @@ Concrete Elasticsearch adapter implementing index management, document CRUD, and
 
 ::: archipy.adapters.elasticsearch.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/email.md

@@ -1,3 +1,8 @@
+---
+title: Email
+description: API reference for the email adapter ports, adapters, and mocks.
+---
+
 # Email
 
 The `email` adapter provides integration with email services for sending transactional and notification emails.
@@ -8,7 +13,6 @@ Abstract port interface defining the email adapter contract.
 
 ::: archipy.adapters.email.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,6 +22,5 @@ Concrete email adapter implementing SMTP-based email sending with ArchiPy conven
 
 ::: archipy.adapters.email.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/index.md

@@ -1,3 +1,8 @@
+---
+title: Adapters Overview
+description: Overview of all available ArchiPy adapter integrations.
+---
+
 # Adapters
 
 The `adapters` module provides concrete implementations of external system integrations following the Ports & Adapters pattern. Each adapter directory exposes a `ports.py` (abstract interface) and an `adapters.py` (concrete implementation).

docs/api_reference/adapters/kafka.md

@@ -1,3 +1,8 @@
+---
+title: Kafka
+description: API reference for the Kafka adapter ports, adapters, and mocks.
+---
+
 # Kafka
 
 The `kafka` adapter provides integration with Apache Kafka for producing and consuming messages in event-driven architectures.
@@ -8,7 +13,6 @@ Abstract port interface defining the Kafka adapter contract for message producti
 
 ::: archipy.adapters.kafka.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,6 +22,5 @@ Concrete Kafka adapter implementing producer and consumer patterns with ArchiPy
 
 ::: archipy.adapters.kafka.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/keycloak.md

@@ -1,3 +1,8 @@
+---
+title: Keycloak
+description: API reference for the Keycloak adapter ports, adapters, and mocks.
+---
+
 # Keycloak
 
 The `keycloak` adapter provides integration with Keycloak for identity and access management, including token validation, user management, and role-based access control.
@@ -8,7 +13,6 @@ Abstract port interface defining the Keycloak adapter contract.
 
 ::: archipy.adapters.keycloak.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,6 +22,5 @@ Concrete Keycloak adapter wrapping the Keycloak REST API for authentication and
 
 ::: archipy.adapters.keycloak.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/minio.md

@@ -1,3 +1,8 @@
+---
+title: MinIO
+description: API reference for the MinIO adapter ports, adapters, and mocks.
+---
+
 # MinIO
 
 The `minio` adapter provides integration with MinIO (and S3-compatible object storage) for uploading, downloading, and managing binary objects.
@@ -8,7 +13,6 @@ Abstract port interface defining the MinIO adapter contract for object storage o
 
 ::: archipy.adapters.minio.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,6 +22,5 @@ Concrete MinIO adapter wrapping the MinIO Python SDK with ArchiPy conventions fo
 
 ::: archipy.adapters.minio.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/payment_gateways.md

@@ -1,15 +1,19 @@
+---
+title: Payment Gateways
+description: API reference for the internet payment gateway adapters including Parsian Shaparak.
+---
+
 # Payment Gateways
 
 The `internet_payment_gateways` adapter provides integration with internet payment gateways. Currently supports Parsian Shaparak, an Iranian payment gateway.
 
 ## Parsian Shaparak
 
-### adapters
+## Adapters
 
 Concrete Parsian Shaparak payment gateway adapter implementing payment initiation, verification, and reversal.
 
 ::: archipy.adapters.internet_payment_gateways.ir.parsian.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/postgres.md

@@ -1,3 +1,8 @@
+---
+title: PostgreSQL
+description: API reference for the PostgreSQL adapter session managers and adapters.
+---
+
 # PostgreSQL
 
 The `postgres/sqlalchemy` adapter provides a PostgreSQL-specific SQLAlchemy integration, including a concrete adapter, session manager, and session manager registry that extend the base SQLAlchemy components.
@@ -8,7 +13,6 @@ PostgreSQL-specific session manager handling connection pooling and lifecycle fo
 
 ::: archipy.adapters.postgres.sqlalchemy.session_managers
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,7 +22,6 @@ Registry for PostgreSQL session manager instances.
 
 ::: archipy.adapters.postgres.sqlalchemy.session_manager_registry
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -28,6 +31,5 @@ Concrete PostgreSQL adapter built on top of the base SQLAlchemy adapter with Pos
 
 ::: archipy.adapters.postgres.sqlalchemy.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3

docs/api_reference/adapters/redis.md

@@ -1,3 +1,8 @@
+---
+title: Redis
+description: API reference for the Redis adapter ports, adapters, and mocks.
+---
+
 # Redis
 
 The `redis` adapter provides a complete Redis integration including the concrete adapter, its abstract port interface, and a mock implementation for testing.
@@ -8,7 +13,6 @@ Abstract port interface defining the Redis adapter contract.
 
 ::: archipy.adapters.redis.ports
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -18,7 +22,6 @@ Concrete Redis adapter wrapping the Redis client with ArchiPy conventions for ca
 
 ::: archipy.adapters.redis.adapters
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3
 
@@ -28,6 +31,5 @@ In-memory mock implementation of the Redis port for use in unit tests and BDD sc
 
 ::: archipy.adapters.redis.mocks
     options:
-      show_source: true
       show_root_toc_entry: false
       heading_level: 3