Merge pull request #89 from marcominerva/develop

Reorganize solution structure and update documentation

Author: marcominerva

MinimalHelpers.slnx

@@ -1,20 +1,21 @@
 <Solution>
-  <Folder Name="/OpenApi/">
-    <Project Path="src/MinimalHelpers.OpenApi/MinimalHelpers.OpenApi.csproj" />
-  </Folder>
-  <Folder Name="/Routing/">
-    <Project Path="src/MinimalHelpers.Routing.Analyzers/MinimalHelpers.Routing.Analyzers.csproj" />
-    <Project Path="src/MinimalHelpers.Routing/MinimalHelpers.Routing.csproj" />
-  </Folder>
-  <Folder Name="/Samples/">
+  <Folder Name="/samples/">
     <Project Path="samples/MinimalSample/MinimalSample.csproj" />
   </Folder>
   <Folder Name="/Solution Items/">
     <File Path=".editorconfig" />
     <File Path=".github/copilot-instructions.md" />
     <File Path="src/Directory.Build.props" />
   </Folder>
-  <Folder Name="/Validation/">
+  <Folder Name="/src/" />
+  <Folder Name="/src/OpenApi/">
+    <Project Path="src/MinimalHelpers.OpenApi/MinimalHelpers.OpenApi.csproj" />
+  </Folder>
+  <Folder Name="/src/Routing/">
+    <Project Path="src/MinimalHelpers.Routing.Analyzers/MinimalHelpers.Routing.Analyzers.csproj" />
+    <Project Path="src/MinimalHelpers.Routing/MinimalHelpers.Routing.csproj" />
+  </Folder>
+  <Folder Name="/src/Validation/">
     <Project Path="src/MinimalHelpers.FluentValidation/MinimalHelpers.FluentValidation.csproj" />
     <Project Path="src/MinimalHelpers.Validation.Abstractions/MinimalHelpers.Validation.Abstractions.csproj" />
     <Project Path="src/MinimalHelpers.Validation/MinimalHelpers.Validation.csproj" />

README.md

@@ -11,19 +11,18 @@ A collection of helper libraries for Minimal API projects.
 [![Nuget](https://img.shields.io/nuget/v/MinimalHelpers.Routing)](https://www.nuget.org/packages/MinimalHelpers.Routing)
 [![Nuget](https://img.shields.io/nuget/dt/MinimalHelpers.Routing)](https://www.nuget.org/packages/MinimalHelpers.Routing)
 
-A library that provides Routing helpers for Minimal API projects for automatic endpoints registration using Reflection.
-
+A library that provides routing helpers for Minimal API projects, enabling automatic endpoint registration using reflection.
 ### Installation
 
-The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.Routing). Just search for *MinimalHelpers.Routing* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
+The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.Routing). Search for *MinimalHelpers.Routing* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
 
 ```shell
 dotnet add package MinimalHelpers.Routing
 ```
 
 ### Usage
 
-Create a class to hold your route handlers registration and have it implement the `IEndpointRouteHandlerBuilder` interface:
+Create a class to hold your route handler registrations and have it implement the `IEndpointRouteHandlerBuilder` interface:
 
 ```csharp
 public class PeopleEndpoints : MinimalHelpers.Routing.IEndpointRouteHandlerBuilder
@@ -41,7 +40,7 @@ public class PeopleEndpoints : MinimalHelpers.Routing.IEndpointRouteHandlerBuild
 }
 ```
 
-Call the `MapEndpoints()` extension method on the **WebApplication** object inside *Program.cs* before invoking the `Run()` method:
+Call the `MapEndpoints()` extension method on the **WebApplication** object in *Program.cs* before invoking the `Run()` method:
 
 ```csharp
 // using MinimalHelpers.Routing;
@@ -81,15 +80,15 @@ A library that provides a Source Generator for automatic endpoints registration
 
 ### Installation
 
-The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.Routing.Analyzers). Just search for *MinimalHelpers.Routing* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
+The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.Routing.Analyzers). Search for *MinimalHelpers.Routing* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
 
 ```shell
 dotnet add package MinimalHelpers.Routing.Analyzers
 ```
 
 ### Usage
 
-Create a class to hold your route handlers registration and have it implement the `IEndpointRouteHandlerBuilder` interface:
+Create a class to hold your route handler registrations and have it implement the `IEndpointRouteHandlerBuilder` interface:
 
 ```csharp
 public class PeopleEndpoints : IEndpointRouteHandlerBuilder
@@ -110,7 +109,7 @@ public class PeopleEndpoints : IEndpointRouteHandlerBuilder
 > **Note**
 You only need to use the **MinimalHelpers.Routing.Analyzers** package. With this Source Generator, the `IEndpointRouteHandlerBuilder` interface is auto-generated.
 
-Call the `MapEndpoints()` extension method on the **WebApplication** object inside *Program.cs* before the `Run()` method invocation:
+Call the `MapEndpoints()` extension method on the **WebApplication** object in *Program.cs* before the `Run()` method invocation:
 
 ```csharp
 app.MapEndpoints();
@@ -130,7 +129,7 @@ A library that provides OpenAPI helpers for Minimal API projects.
 
 ### Installation
 
-The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.OpenApi). Just search for *MinimalHelpers.OpenApi* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
+The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.OpenApi). Search for *MinimalHelpers.OpenApi* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
 
 ```shell
 dotnet add package MinimalHelpers.OpenApi
@@ -140,7 +139,7 @@ dotnet add package MinimalHelpers.OpenApi
 
 ***Extension methods for OpenApi***
 
-This library provides several extension methods that simplify the OpenAPI configuration in Minimal API projects. For example, it is possible to customize the description of a response using its status code:
+This library provides several extension methods that simplify the OpenAPI configuration in Minimal API projects. For example, you can customize the description of a response using its status code:
 
 ```csharp
 endpoints.MapPost("login", LoginAsync)
@@ -175,7 +174,7 @@ endpoints.MapPost("login", LoginAsync)
     .ProducesProblem(StatusCodes.Status404NotFound);
  ```
 
-To avoid multiple calls to `ProducesProblem`, use the `ProducesDefaultProblem` extension method provided by the library::
+To avoid multiple calls to `ProducesProblem`, use the `ProducesDefaultProblem` extension method provided by the library:
 
  ```csharp
 endpoints.MapGet("/api/people/{id:guid}", Get)
@@ -188,11 +187,11 @@ endpoints.MapGet("/api/people/{id:guid}", Get)
 [![Nuget](https://img.shields.io/nuget/v/MinimalHelpers.Validation)](https://www.nuget.org/packages/MinimalHelpers.Validation)
 [![Nuget](https://img.shields.io/nuget/dt/MinimalHelpers.Validation)](https://www.nuget.org/packages/MinimalHelpers.Validation)
 
-A library that provides an Endpoint filter for Minimal API projects to perform validation with Data Annotations, using the <a href="https://github.com/DamianEdwards/MiniValidation">MiniValidation</a> library.
+A library that provides an endpoint filter for Minimal API projects to perform validation using Data Annotations and the <a href="https://github.com/DamianEdwards/MiniValidation">MiniValidation</a> library.
 
 ### Installation
 
-The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.Validation). Just search for *MinimalHelpers.Validation* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
+The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.Validation). Search for *MinimalHelpers.Validation* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
 
 ```shell
 dotnet add package MinimalHelpers.Validation
@@ -275,11 +274,11 @@ You can use the `ValidationErrorTitleMessageFactory`, for example, if you want t
 [![Nuget](https://img.shields.io/nuget/v/MinimalHelpers.FluentValidation)](https://www.nuget.org/packages/MinimalHelpers.FluentValidation)
 [![Nuget](https://img.shields.io/nuget/dt/MinimalHelpers.FluentValidation)](https://www.nuget.org/packages/MinimalHelpers.FluentValidation)
 
-A library that provides an Endpoint filter for Minimal API projects to perform validation using <a href="https://fluentvalidation.net">FluentValidation</a>.
+A library that provides an endpoint filter for Minimal API projects to perform validation using <a href="https://fluentvalidation.net">FluentValidation</a>.
 
 ### Installation
 
-The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.FluentValidation). Just search for *MinimalHelpers.FluentValidation* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
+The library is available on [NuGet](https://www.nuget.org/packages/MinimalHelpers.FluentValidation). Search for *MinimalHelpers.FluentValidation* in the **Package Manager GUI** or run the following command in the **.NET CLI**:
 
 ```shell
 dotnet add package MinimalHelpers.FluentValidation
@@ -368,4 +367,4 @@ You can use the `ValidationErrorTitleMessageFactory`, for example, if you want t
 
 **Contributing**
 
-The project is constantly evolving. Contributions are welcome! Please file issues or pull requests in the repository and they will be addressed as soon as possible.
+The project is constantly evolving. Contributions are welcome. Feel free to file issues and pull requests in the repository, and we'll address them as we can.

samples/MinimalSample/MinimalSample.csproj

@@ -8,9 +8,9 @@
 
 	<ItemGroup>
 		<PackageReference Include="FluentValidation.DependencyInjectionExtensions" Version="12.0.0" />
-		<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.8" />
+		<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.9" />
 		<PackageReference Include="Swashbuckle.AspNetCore.SwaggerUI" Version="9.0.4" />
-		<PackageReference Include="TinyHelpers.AspNetCore" Version="4.1.4" />
+		<PackageReference Include="TinyHelpers.AspNetCore" Version="4.1.6" />
 	</ItemGroup>
 
 	<ItemGroup>

src/MinimalHelpers.OpenApi/MinimalHelpers.OpenApi.csproj

@@ -30,11 +30,11 @@
     </ItemGroup>
 
     <ItemGroup Condition="'$(TargetFramework)' == 'net8.0'">
-        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="8.0.19" />
+        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="8.0.20" />
     </ItemGroup>
 
     <ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
-        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.8" />
+        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.9" />
     </ItemGroup>
 
     <ItemGroup>