fix(docs): refine adoption guides structure and links

Author: bsayli

docs/_config.yml

@@ -8,12 +8,14 @@ plugins:
 
 baseurl: "/openapi-generics"
 
-just_the_docs:
-  custom_css:
-    - assets/css/custom.css
+# TOC davranışı (Home sayfa için kritik)
+toc:
+  min_level: 2
+  max_level: 2
 
+# Üst sağ link
 aux_links:
-  "View on GitHub":
+  "GitHub":
     - "https://github.com/blueprint-platform/openapi-generics"
 
 search_enabled: true

docs/adoption/client-side-adoption.md

@@ -3,6 +3,8 @@ layout: default
 title: Client-Side Adoption
 parent: Adoption Guides
 nav_order: 2
+has_toc: true
+toc_label: "Contents"
 ---
 
 # Client-Side Adoption — Contract-First Client Integration
@@ -29,24 +31,6 @@ It focuses on four things:
 
 ---
 
-## 📑 Table of Contents
-
-* [⚡ 60-second quick start](#-60-second-quick-start)
-* [🎯 What the client actually does](#-what-the-client-actually-does)
-* [📥 Input: OpenAPI (not your contract)](#-input-openapi-not-your-contract)
-* [📦 Minimal setup](#-minimal-setup)
-* [🧠 Progressive adoption modes (0.9.x)](#-progressive-adoption-modes-09x)
-* [🏗 Build pipeline (what really happens)](#-build-pipeline-what-really-happens)
-* [🧠 Output: what gets generated](#-output-what-gets-generated)
-* [🚀 Usage: how the client enters your system](#-usage-how-the-client-enters-your-system)
-* [🧱 Adapter boundary (strongly recommended)](#-adapter-boundary-strongly-recommended)
-* [🔍 Quick verification](#-quick-verification)
-* [⚠️ Error handling](#-error-handling)
-* [🧠 Mental model](#-mental-model)
-* [🧾 Summary](#-summary)
-
----
-
 ## ⚡ 60-second quick start
 
 You want:

docs/adoption/server-side-adoption.md

@@ -3,6 +3,8 @@ layout: default
 title: Server-Side Adoption
 parent: Adoption Guides
 nav_order: 1
+has_toc: true
+toc_label: "Contents"
 ---
 
 # Server-Side Adoption — Contract-First OpenAPI Publication
@@ -16,23 +18,6 @@ The platform guarantees a **stable, generator-ready OpenAPI projection**.
 
 ---
 
-## 📑 Table of Contents
-
-* [⚡ 60-second quick start](#-60-second-quick-start)
-* [🎯 What the server actually does](#-what-the-server-actually-does)
-* [🧩 The only rule that matters](#-the-only-rule-that-matters)
-* [📦 Minimal dependencies](#-minimal-dependencies)
-* [✍️ What you actually write](#-what-you-actually-write)
-* [🧠 What gets published to OpenAPI](#-what-gets-published-to-openapi)
-* [🔁 Projection pipeline (what really happens)](#-projection-pipeline-what-really-happens)
-* [⚠️ Rules (do NOT break these)](#-rules-do-not-break-these)
-* [🔍 Quick verification](#-quick-verification)
-* [📦 Samples (recommended)](#-samples-recommended)
-* [🧠 Mental model](#-mental-model)
-* [🧾 Summary](#-summary)
-
----
-
 ## ⚡ 60-second quick start
 
 You want:

docs/architecture/summary/client-code-generation.md

@@ -1,3 +1,8 @@
+---
+title: openapi-generics-client-side — Summary (0.9.x)
+nav_exclude: true
+---
+
 # openapi-generics Client Side — Summary
 
 ## What the client side is now

docs/architecture/summary/server-openapi-projection.md

@@ -1,3 +1,9 @@
+---
+title: openapi-generics Server Side — Summary (0.9.x)
+nav_exclude: true
+---
+
+
 # openapi-generics Server Side — Summary
 
 ## What this module is now

docs/index.md

@@ -2,6 +2,8 @@
 layout: default
 title: Home
 nav_order: 1
+has_toc: true
+toc_label: "Contents"
 ---
 
 # OpenAPI Generics — Keep Your API Contract Intact End-to-End
@@ -11,32 +13,6 @@ nav_order: 1
 
 ---
 
-## Table of Contents
-
-* [Why this exists](#why-this-exists)
-* [What you actually do](#what-you-actually-do)
-* [Quick Start](#-quick-start)
-
-  * [1. Server (producer)](#1-server-producer)
-  * [2. Client (consumer)](#2-client-consumer)
-* [Result](#result)
-* [Compatibility Matrix](#-compatibility-matrix)
-* [Proof — Generated Client (Before vs After)](#proof--generated-client-before-vs-after)
-
-  * [Before (default OpenAPI behavior)](#before-default-openapi-behavior)
-  * [After (contract-aligned generation)](#after-contract-aligned-generation)
-* [What changed](#what-changed)
-* [What is actually generated](#what-is-actually-generated)
-* [How you actually use it](#how-you-actually-use-it)
-* [What this gives you](#what-this-gives-you)
-* [Why this matters](#why-this-matters)
-* [Mental model](#mental-model)
-* [Next steps](#next-steps)
-* [References & External Links](#-references--external-links)
-* [Final note](#final-note)
-
----
-
 ## Why this exists
 
 In most OpenAPI-based workflows: