docs: Improve Readme (#28)

Author: xC0dex

README.md

@@ -3,18 +3,45 @@
 [![Pipeline](https://github.com/xC0dex/APIWeaver/actions/workflows/ci.yml/badge.svg)](https://github.com/xC0dex/APIWeaver/actions/workflows/ci.yml)
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=xC0dex_APIWeaver&metric=coverage)](https://sonarcloud.io/summary/new_code?id=xC0dex_APIWeaver)
 [![NuGet Version](https://img.shields.io/nuget/v/APIWeaver.Swagger)](https://www.nuget.org/packages/APIWeaver.Swagger/)
-[![NuGet Version](https://img.shields.io/nuget/dt/APIWeaver.OpenApi)](https://www.nuget.org/packages/APIWeaver.Swagger/)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/APIWeaver.OpenApi)](https://www.nuget.org/packages/APIWeaver.Swagger/)
 
 
-APIWeaver is a powerful, lightweight, and feature-rich library designed to provide comprehensive OpenAPI support in .NET
-6 and newer.
+APIWeaver is a powerful and lightweight library designed to provide a seamless integration of OpenAPI and Swagger UI into your .NET 6+ apps. APIWeaver supports the latest .NET 8 features and is designed to be future-proof, ensuring support for upcoming .NET and OpenAPI features.
 
-APIWeaver is committed to long-term development, ensuring support for upcoming .NET and OpenAPI features.
 
 ## Work in progress
 
-This project is currently in the **active development** phase, with ongoing improvements, new features and potential API
-changes. Contributions of any kind are highly appreciated!
+This project is currently under **active development**, with ongoing improvements, new features and potential API
+changes. I encourage you to try it out and provide feedback, but please be aware that the library is not yet stable.
+
+## Getting Started
+
+To get started with APIWeaver, you can install the NuGet package using your preferred package manager. In most cases, the package `APIWeaver.Swagger` is the one you are looking for.
+
+1. Install the NuGet package
+```shell
+dotnet add package APIWeaver.Swagger
+```
+
+2. Add the using directive to your Program.cs file
+```csharp
+using APIWeaver;
+```
+
+3. Add the following lines to your `Program.cs` file.
+```csharp
+builder.Services.AddApiWeaver();
+
+// other code
+
+if (app.Environment.IsDevelopment())
+{
+    app.UseSwaggerUi();
+}
+```
+
+That's it. You now have a fully functional Swagger UI in your application. The UI can be accessed by navigating to /swagger in your browser 🥳. A more detailed guide with more use cases can be found here.
+
 
 ## Contribution and Collaboration
 
@@ -23,5 +50,5 @@ success!
 
 ## License
 
-Distributed under the MIT License. See LICENSE for more information.
+Distributed under the MIT License. See [LICENSE](LICENSE) for more information.
 This means APIWeaver will always remain free.

docs/Getting-Started.md

@@ -0,0 +1 @@
+# Coming soon

docs/README.md

@@ -0,0 +1 @@
+# Coming soon