Aggiunta documentazione Swagger minima

Author: AngeloDotNet

src/NET6CustomLibrary/Docs/README-Swagger.md

@@ -1,14 +1,52 @@
 # SwaggerUI configuration
 
 
-## Registering services at Startup
+## Registering services at Startup (with xml documentation)
 
 ```csharp
 public Startup(IConfiguration configuration)
 {
   Configuration = configuration;
 }
 
+public IConfiguration Configuration { get; }
+	
+public void ConfigureServices(IServiceCollection services)
+{
+  var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
+  var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
+
+  services.AddSwaggerGenConfig("My Web Api", "v1", "Add here a description which will be shown in the swagger UI", true, xmlPath);
+  //OR services.AddSwaggerGenConfig("My Web Api", "v1", string.Empty, true, xmlPath);
+}
+
+//OMISSIS
+
+public void Configure(WebApplication app)
+{
+  app.AddUseSwaggerUI("My Web Api v1");
+}
+```
+
+<b>Note:</b> If you want to add xml documentation to web api you need to add TRUE value to GenerateDocumentationFile tag to csproj project file.
+
+
+## Registering services at Startup (without xml documentation)
+
+```csharp
+public Startup(IConfiguration configuration)
+{
+  Configuration = configuration;
+}
+
+public IConfiguration Configuration { get; }
+	
+public void ConfigureServices(IServiceCollection services)
+{
+  services.AddSwaggerGenConfig("My Web Api", "v1", "Add here a description which will be shown in the swagger UI");
+  //OR services.AddSwaggerGenConfig("My Web Api", "v1", string.Empty);
+}
+
 //OMISSIS
 
 public void Configure(WebApplication app)

src/NET6CustomLibrary/Swagger/SwaggerSimple.cs

@@ -0,0 +1,29 @@
+namespace NET6CustomLibrary.Swagger;
+
+public static class SwaggerSimple
+{
+    public static IServiceCollection AddSwaggerGenConfig(this IServiceCollection services, string title,
+        string version, string description = "", bool extendSchema = false, string xmlCommentsPath = "")
+    {
+        services
+            .AddEndpointsApiExplorer()
+            .AddSwaggerGen(options =>
+            {
+                options.OperationFilter<CultureAwareOperationFilter>();
+                options.SwaggerDoc($"{version}", new OpenApiInfo
+                {
+                    Title = $"{title}",
+                    Version = $"{version}",
+                    Description = $"{description}",
+                });
+
+                if (extendSchema)
+                    options.UseAllOfToExtendReferenceSchemas();
+
+                if (xmlCommentsPath is not (null or ""))
+                    options.IncludeXmlComments(xmlCommentsPath);
+            });
+
+        return services;
+    }
+}