Update README.md

Signed-off-by: Ayush Srivastava <ayush.srivastav@icloud.com>

Author: ayushshrivastv

README.md

@@ -1,17 +1,12 @@
 # OpenAPI Integration with DocC
 
-This project provides tools and examples for integrating OpenAPI specifications with Apple's DocC documentation system. It allows developers to create beautiful, interactive documentation for REST APIs that matches the style and quality of Swift API documentation.
+The project aims to bridge the gap between OpenAPI specifications and Swift's DocC documentation framework by developing a tool that automates the generation of DocC documentation from OpenAPI files.
 
 ## Overview
 
 OpenAPI is the industry standard for documenting HTTP services, but Swift developers are already familiar with DocC for their Swift and Objective-C API documentation. This project bridges that gap by converting OpenAPI specifications into a format that DocC can understand and render.
 
-## Key Features
-
-- Convert OpenAPI 3.1.0 specifications to DocC-compatible format
-- Generate beautiful API documentation
-- Provide a consistent documentation experience for Swift developers
-- Support for documenting endpoints, schemas, parameters, and more
+![2048](https://github.com/user-attachments/assets/f9a751be-9d2f-43f0-8346-04af7edaea57)
 
 ## Project Structure
 
@@ -23,6 +18,13 @@ The project is organized into several modules:
   - `Mapping` - Mappers between OpenAPI and SymbolGraph
   - `Utils/DocC` - DocC integration utilities
 
+## Key Features
+
+- Convert OpenAPI 3.1.0 specifications to DocC compatible format
+- Generate API documentation
+- Provide a consistent documentation experience for Swift developers
+- Support for documenting endpoints, schemas, parameters, and more
+
 ## Getting Started
 
 ### Prerequisites
@@ -44,7 +46,6 @@ swift build
 1. Convert your OpenAPI specification to a SymbolGraph:
 
 ```bash
-# Example using one of the provided files
 swift run openapi-to-symbolgraph Examples/api.yaml --output-path api.symbolgraph.json
 ```
 
@@ -57,6 +58,7 @@ The tool has also been tested with the standard Swagger Pet Store OpenAPI defini
 # curl -o Examples/petstore.yaml https://raw.githubusercontent.com/swagger-api/swagger-petstore/master/src/main/resources/openapi.yaml
 
 # Convert the Pet Store spec
+
 swift run openapi-to-symbolgraph Examples/petstore.yaml --output-path petstore.symbolgraph.json
 ```
 
@@ -72,15 +74,15 @@ xcrun docc convert YourAPI.docc --fallback-display-name YourAPI --fallback-bundl
 
 The `docs/` directory in this repository contains the pre-generated DocC documentation website output for the **Swagger Pet Store API**, which was built using the `petstore.symbolgraph.json` generated by this tool and the `API.docc` catalog.
 
-### Online Documentation
+### Documentation
 
 The latest documentation is automatically deployed to GitHub Pages and can be viewed at:
 
 [https://ayushshrivastv.github.io/OpenAPI-integration-with-DocC/](https://ayushshrivastv.github.io/OpenAPI-integration-with-DocC/)
 
 ### Local Documentation Server
 
-You can serve the included Pet Store documentation locally using one of these methods:
+You can serve the documentation locally using one of these methods:
 
 #### Using the helper script: