feat: update version to 1.0.16 and enhance README with configuration options for OpenAPI UI middleware

Author: jakubkozera

src/c-sharp/JakubKozera.OpenApiUi/JakubKozera.OpenApiUi.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFrameworks>net6.0;net8.0;net9.0</TargetFrameworks>
     <PackageId>JakubKozera.OpenApiUi</PackageId>
-    <Version>1.0.15</Version>
+    <Version>1.0.16</Version>
     <Authors>Jakub Kozera</Authors>
     <Description>A .NET library serving OpenAPI UI with HTML/CSS</Description>
     <PackageTags>openapi;ui;html;css;dotnet</PackageTags>

src/c-sharp/JakubKozera.OpenApiUi/Lib/OpenApiUiMiddleware.cs

@@ -90,6 +90,23 @@ public static IApplicationBuilder UseOpenApiUi(this IApplicationBuilder app, Ope
             return app;
         }
 
+        /// <summary>
+        /// Adds OpenAPI UI middleware to the ASP.NET Core application pipeline with a configuration action.
+        /// This middleware serves an embedded OpenAPI documentation interface.
+        /// </summary>
+        /// <param name="app">The application builder instance.</param>
+        /// <param name="configureOptions">An action to configure the OpenAPI UI options.</param>
+        /// <returns>The application builder instance for method chaining.</returns>
+        public static IApplicationBuilder UseOpenApiUi(this IApplicationBuilder app, Action<OpenApiUiConfiguration> configureOptions)
+        {
+            if (configureOptions == null)
+                throw new ArgumentNullException(nameof(configureOptions));
+
+            var configuration = new OpenApiUiConfiguration();
+            configureOptions(configuration);
+            return UseOpenApiUi(app, configuration);
+        }
+
         /// <summary>
         /// Adds OpenAPI UI middleware to the ASP.NET Core application pipeline with default configuration.
         /// This middleware serves an embedded OpenAPI documentation interface.

src/c-sharp/JakubKozera.OpenApiUi/README.md

@@ -104,16 +104,52 @@ app.Run();
 
 ### 2. Access the OpenAPI UI
 
-Navigate to `/openapi-ui` in your browser to view the API documentation interface.
+Navigate to `/openapi-ui` in your browser to view the API documentation interface (or your custom path if configured).
+
+**Note:** The default UI path is `/openapi-ui` and the default OpenAPI specification path is `/swagger/v1/swagger.json`.
 
 ## Configuration
 
-### Custom OpenAPI Specification Path
+### Basic Configuration Options
+
+The middleware provides several overloads for different configuration needs:
+
+#### Default Configuration
+
+```csharp
+app.UseOpenApiUi(); // Uses default settings
+```
+
+**Default values:**
+
+- `OpenApiSpecPath`: `"/swagger/v1/swagger.json"`
+- `OpenApiUiPath`: `"openapi-ui"`
+
+#### Simple Path Configuration
+
+```csharp
+app.UseOpenApiUi("/api/docs/swagger.json"); // Custom OpenAPI spec path only
+```
+
+#### Fluent Configuration
+
+```csharp
+app.UseOpenApiUi(config =>
+{
+    config.OpenApiSpecPath = "/api/v2/openapi.json";  // Custom spec path
+    config.OpenApiUiPath = "api-docs";                // Custom UI path
+});
+```
 
-You can specify a custom path to your OpenAPI specification:
+#### Configuration Object
 
 ```csharp
-app.UseOpenApiUi("/api/docs/swagger.json");
+var configuration = new OpenApiUiConfiguration
+{
+    OpenApiSpecPath = "/api/docs/swagger.json",
+    OpenApiUiPath = "docs"
+};
+app.UseOpenApiUi(configuration);
 ```
 
 ## Usage Examples
@@ -140,8 +176,11 @@ var app = builder.Build();
 // add OpenUI specification
 app.UseSwagger();
 
-// add OpenAPI UI
-app.UseOpenApiUi();
+// add OpenAPI UI with custom configuration
+app.UseOpenApiUi(config =>
+{
+    config.OpenApiUiPath = "api-docs";  // Access via /api-docs instead of default /openapi-ui
+});
 
 app.UseHttpsRedirection();
 app.UseAuthorization();
@@ -150,6 +189,33 @@ app.MapControllers();
 app.Run();
 ```
 
+### Advanced Configuration
+
+```csharp
+// Custom path and specification
+app.UseOpenApiUi(config =>
+{
+    config.OpenApiSpecPath = "/api/v2/openapi.json";  // Different spec location
+    config.OpenApiUiPath = "documentation";           // Custom UI path
+});
+
+// Multiple API versions
+if (app.Environment.IsDevelopment())
+{
+    app.UseOpenApiUi(config =>
+    {
+        config.OpenApiSpecPath = "/swagger/v1/swagger.json";
+        config.OpenApiUiPath = "docs/v1";
+    });
+
+    app.UseOpenApiUi(config =>
+    {
+        config.OpenApiSpecPath = "/swagger/v2/swagger.json";
+        config.OpenApiUiPath = "docs/v2";
+    });
+}
+```
+
 ## Requirements
 
 - .NET 6.0, 8.0, or 9.0