Merge pull request #9 from lukasz-antoniak/doc-5

Fix ToC

Author: SiyaoIsHiding

.github/workflows/publish-docs-gp-pages.yml

@@ -1,10 +1,6 @@
-name: publish-docs-gp-pages
+name: publish-docs-gh-pages
 
 on:
-# TODO: Can we trigger action manually?
-#  push:
-#    branches:
-#      - 4.x
   workflow_dispatch:
 
 jobs:

mkdocs.yml

@@ -24,7 +24,7 @@ markdown_extensions:
   - pymdownx.superfences
   - pymdownx.tabbed
   - toc:
-      toc_depth: 1
+      toc_depth: 2-3
       permalink: true
 
 nav:
@@ -40,47 +40,54 @@ nav:
       - Configuration:
         - Overview: manual/core/configuration/README.md
         - Reference: manual/core/configuration/reference/README.md
-      - Authentication: manual/core/authentication/README.md
-      - SSL: manual/core/ssl/README.md
-      - Load Balancing: manual/core/load_balancing/README.md
-      - Pooling: manual/core/pooling/README.md
-      - Reconnection: manual/core/reconnection/README.md
-      - Retries: manual/core/retries/README.md
-      - Speculative Execution: manual/core/speculative_execution/README.md
-      - Metrics: manual/core/metrics/README.md
-      - Logging: manual/core/logging/README.md
+      - Connection Management:
+        - Authentication: manual/core/authentication/README.md
+        - SSL: manual/core/ssl/README.md
+        - Pooling: manual/core/pooling/README.md
+        - Load Balancing: manual/core/load_balancing/README.md
+        - Reconnection: manual/core/reconnection/README.md
+        - Address Resolution: manual/core/address_resolution/README.md
       - Statements:
         - Overview: manual/core/statements/README.md
         - Batch: manual/core/statements/batch/README.md
         - Per Query Keyspace: manual/core/statements/per_query_keyspace/README.md
         - Prepared: manual/core/statements/prepared/README.md
         - Simple: manual/core/statements/simple/README.md
-      - Paging: manual/core/paging/README.md
-      - Async Programming: manual/core/async/README.md
-      - Reactive Streams: manual/core/reactive/README.md
-      - Custom Codecs: manual/core/custom_codecs/README.md
-      - Temporal Types: manual/core/temporal_types/README.md
-      - Tuples: manual/core/tuples/README.md
-      - UDTs: manual/core/udts/README.md
-      - Compression: manual/core/compression/README.md
-      - Address Resolution: manual/core/address_resolution/README.md
-      - Request Tracker: manual/core/request_tracker/README.md
-      - Request ID: manual/core/request_id/README.md
-      - Throttling: manual/core/throttling/README.md
-      - Tracing: manual/core/tracing/README.md
-      - Performance: manual/core/performance/README.md
+      - Query Execution:
+        - Retries: manual/core/retries/README.md
+        - Idempotence: manual/core/idempotence/README.md
+        - Speculative Execution: manual/core/speculative_execution/README.md
+        - Paging: manual/core/paging/README.md
+        - Query Timestamps: manual/core/query_timestamps/README.md
+      - Advanced Types:
+        - Custom Codecs: manual/core/custom_codecs/README.md
+        - Temporal Types: manual/core/temporal_types/README.md
+        - Tuples: manual/core/tuples/README.md
+        - UDTs: manual/core/udts/README.md
+        - Detachable Types: manual/core/detachable_types/README.md
+      - Non-blocking:
+        - Overview: manual/core/non_blocking/README.md
+        - Async Programming: manual/core/async/README.md
+        - Reactive Streams: manual/core/reactive/README.md
+      - Observability:
+        - Request Tracker: manual/core/request_tracker/README.md
+        - Request ID: manual/core/request_id/README.md
+        - Metrics: manual/core/metrics/README.md
+        - Logging: manual/core/logging/README.md
+        - Tracing: manual/core/tracing/README.md
+      - Performance:
+        - Overview: manual/core/performance/README.md
+        - Throttling: manual/core/throttling/README.md
+        - Compression: manual/core/compression/README.md
       - Metadata:
         - Overview: manual/core/metadata/README.md
         - Node: manual/core/metadata/node/README.md
         - Schema: manual/core/metadata/schema/README.md
         - Token: manual/core/metadata/token/README.md
-      - Control Connection: manual/core/control_connection/README.md
-      - Native Protocol: manual/core/native_protocol/README.md
-      - Non-blocking: manual/core/non_blocking/README.md
-      - Query Timestamps: manual/core/query_timestamps/README.md
-      - Idempotence: manual/core/idempotence/README.md
-      - Detachable Types: manual/core/detachable_types/README.md
-      - DSE:
+      - Driver Internals:
+        - Control Connection: manual/core/control_connection/README.md
+        - Native Protocol: manual/core/native_protocol/README.md
+      - DataStax DSE:
         - Overview: manual/core/dse/README.md
         - Geotypes: manual/core/dse/geotypes/README.md
         - Graph: