docs(root): restructure README with social preview & clearer flow

- Moved social preview image directly under badges for better visibility
- Clarified intro with immediate project purpose statement
- Streamlined Problem → Solution → Quick Start sequence
- Kept adapter usage, key features, and related modules intact

Author: barissayli

README.md

@@ -10,6 +10,18 @@
 
 ---
 
+<p align="center">
+  <img src="docs/images/social-preview.png" alt="Social preview" width="720"/>
+  <br/>
+  <em>Type-safe API responses without boilerplate — powered by Spring Boot & OpenAPI Generator</em>
+</p>
+
+**Type-safe client generation with Spring Boot & OpenAPI using generics.**
+This repository demonstrates how to extend OpenAPI Generator to work with generics in order to avoid boilerplate, reduce
+duplicated wrappers, and keep client code clean.
+
+---
+
 ## 📑 Table of Contents
 
 - 📦 [Modules](#-modules-in-this-repository)
@@ -44,18 +56,6 @@ This repository consists of two main modules:
 
 ---
 
-<p align="center">
-  <img src="docs/images/social-preview.png" alt="Social preview" width="720"/>
-  <br/>
-  <em>Type-safe API responses without boilerplate — powered by Spring Boot & OpenAPI Generator</em>
-</p>
-
-**Type-safe client generation with Spring Boot & OpenAPI using generics.**
-This repository demonstrates how to extend OpenAPI Generator to work with generics in order to avoid boilerplate, reduce
-duplicated wrappers, and keep client code clean.
-
----
-
 ## 🚀 Problem Statement
 
 Most backend teams standardize responses with a generic wrapper like `ServiceResponse<T>`.