docs: improve api_reference formatting and remove duplicate scylladb content

Author: HosseinNejatiJavaremi

docs/api_reference/adapters/base.md

@@ -2,47 +2,52 @@
 
 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.
 
-## ports
+## Ports
 
 Abstract port interface defining the contract all SQLAlchemy-based adapters must fulfil.
 
 ::: archipy.adapters.base.sqlalchemy.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## session_manager_ports
+## Session Manager Ports
 
 Abstract interface for SQLAlchemy session managers, decoupling session lifecycle from adapter logic.
 
 ::: archipy.adapters.base.sqlalchemy.session_manager_ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## session_manager_registry
+## Session Manager Registry
 
 Registry for tracking and resolving active session manager instances.
 
 ::: archipy.adapters.base.sqlalchemy.session_manager_registry
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## session_managers
+## Session Managers
 
 Concrete session manager implementations that handle SQLAlchemy session creation, scoping, and teardown.
 
 ::: archipy.adapters.base.sqlalchemy.session_managers
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 The base SQLAlchemy adapter implements generic CRUD operations that concrete database adapters (PostgreSQL, SQLite, StarRocks) inherit from.
 
 ::: archipy.adapters.base.sqlalchemy.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/elasticsearch.md

@@ -2,20 +2,22 @@
 
 The `elasticsearch` adapter provides integration with Elasticsearch for full-text search, document indexing, and analytics queries.
 
-## ports
+## Ports
 
 Abstract port interface defining the Elasticsearch adapter contract.
 
 ::: archipy.adapters.elasticsearch.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete Elasticsearch adapter implementing index management, document CRUD, and search operations.
 
 ::: archipy.adapters.elasticsearch.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/email.md

@@ -2,20 +2,22 @@
 
 The `email` adapter provides integration with email services for sending transactional and notification emails.
 
-## ports
+## Ports
 
 Abstract port interface defining the email adapter contract.
 
 ::: archipy.adapters.email.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete email adapter implementing SMTP-based email sending with ArchiPy conventions.
 
 ::: archipy.adapters.email.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/kafka.md

@@ -2,20 +2,22 @@
 
 The `kafka` adapter provides integration with Apache Kafka for producing and consuming messages in event-driven architectures.
 
-## ports
+## Ports
 
 Abstract port interface defining the Kafka adapter contract for message production and consumption.
 
 ::: archipy.adapters.kafka.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete Kafka adapter implementing producer and consumer patterns with ArchiPy conventions.
 
 ::: archipy.adapters.kafka.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/keycloak.md

@@ -2,20 +2,22 @@
 
 The `keycloak` adapter provides integration with Keycloak for identity and access management, including token validation, user management, and role-based access control.
 
-## ports
+## Ports
 
 Abstract port interface defining the Keycloak adapter contract.
 
 ::: archipy.adapters.keycloak.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete Keycloak adapter wrapping the Keycloak REST API for authentication and authorization operations.
 
 ::: archipy.adapters.keycloak.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/minio.md

@@ -2,20 +2,22 @@
 
 The `minio` adapter provides integration with MinIO (and S3-compatible object storage) for uploading, downloading, and managing binary objects.
 
-## ports
+## Ports
 
 Abstract port interface defining the MinIO adapter contract for object storage operations.
 
 ::: archipy.adapters.minio.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete MinIO adapter wrapping the MinIO Python SDK with ArchiPy conventions for object storage operations.
 
 ::: archipy.adapters.minio.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/payment_gateways.md

@@ -10,5 +10,6 @@ Concrete Parsian Shaparak payment gateway adapter implementing payment initiatio
 
 ::: archipy.adapters.internet_payment_gateways.ir.parsian.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/postgres.md

@@ -2,29 +2,32 @@
 
 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.
 
-## session_managers
+## Session Managers
 
 PostgreSQL-specific session manager handling connection pooling and lifecycle for PostgreSQL databases.
 
 ::: archipy.adapters.postgres.sqlalchemy.session_managers
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## session_manager_registry
+## Session Manager Registry
 
 Registry for PostgreSQL session manager instances.
 
 ::: archipy.adapters.postgres.sqlalchemy.session_manager_registry
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete PostgreSQL adapter built on top of the base SQLAlchemy adapter with PostgreSQL-specific configuration.
 
 ::: archipy.adapters.postgres.sqlalchemy.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/redis.md

@@ -2,29 +2,32 @@
 
 The `redis` adapter provides a complete Redis integration including the concrete adapter, its abstract port interface, and a mock implementation for testing.
 
-## ports
+## Ports
 
 Abstract port interface defining the Redis adapter contract.
 
 ::: archipy.adapters.redis.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete Redis adapter wrapping the Redis client with ArchiPy conventions for cache operations, pub/sub, and key-value management.
 
 ::: archipy.adapters.redis.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## mocks
+## Mocks
 
 In-memory mock implementation of the Redis port for use in unit tests and BDD scenarios.
 
 ::: archipy.adapters.redis.mocks
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3

docs/api_reference/adapters/scylladb.md

@@ -2,20 +2,22 @@
 
 The `scylladb` adapter provides integration with ScyllaDB (and Apache Cassandra) for high-throughput, low-latency wide-column store operations.
 
-## ports
+## Ports
 
 Abstract port interface defining the ScyllaDB adapter contract.
 
 ::: archipy.adapters.scylladb.ports
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3
 
-## adapters
+## Adapters
 
 Concrete ScyllaDB adapter implementing session management and query execution for ScyllaDB/Cassandra clusters.
 
 ::: archipy.adapters.scylladb.adapters
     options:
-      show_root_heading: true
       show_source: true
+      show_root_toc_entry: false
+      heading_level: 3