fix(docs): switch to auto-generated TOC and clean up manual lists

Author: bsayli

docs/adoption/client-side-adoption.md

@@ -8,6 +8,7 @@ toc_label: "Contents"
 ---
 
 # Client-Side Adoption — Contract-First Client Integration
+{: .no_toc }
 
 > Generate a Java client that **preserves contract semantics exactly as published** — with **progressive adoption**, **zero duplication**, and **no drift**.
 
@@ -29,7 +30,8 @@ It focuses on four things:
 * optionally aligning with an external contract
 * using the generated client safely
 
----
+1. TOC
+{:toc}
 
 ## ⚡ 60-second quick start
 

docs/adoption/server-side-adoption.md

@@ -8,14 +8,18 @@ toc_label: "Contents"
 ---
 
 # Server-Side Adoption — Contract-First OpenAPI Publication
+{: .no_toc }
 
 > Publish a **deterministic, generics-aware OpenAPI** from Spring Boot with **one contract and zero duplication**.
 
 This is a **contract-first projection system**, not a documentation tool.
 
-You define your contract in Java.
+You define your contract in Java.  
 The platform guarantees a **stable, generator-ready OpenAPI projection**.
 
+1. TOC
+{:toc}
+
 ---
 
 ## ⚡ 60-second quick start

docs/index.md

@@ -7,10 +7,14 @@ toc_label: "Contents"
 ---
 
 # OpenAPI Generics — Keep Your API Contract Intact End-to-End
+{: .no_toc }
 
 > Define your API once in Java.
 > Preserve it across OpenAPI and generated clients — without duplication or drift.
 
+1. TOC
+{:toc}
+
 ---
 
 ## Why this exists