Intent.AspNetCore.Swashbuckle

This module installs and configures Swashbuckle.AspNetCore.

Swashbuckle.AspNetCore is a popular open-source library for ASP.NET Core applications that simplifies the process of adding Swagger support. Swagger is a set of tools and specifications for describing and visualizing RESTful APIs. Swashbuckle.AspNetCore integrates Swagger into ASP.NET Core projects, enabling developers to automatically generate interactive API documentation, known as Swagger UI, and JSON-formatted API specifications, known as Swagger/OpenAPI specification. With Swashbuckle.AspNetCore, developers can easily expose the details of their Web API, including available endpoints, request and response models, and supported HTTP methods. This makes it easier for developers and third-party consumers to understand, test, and interact with the API, promoting better communication and collaboration between frontend and backend teams.

This module specifically deals with:

• Dependency Injection wiring
• Swashbuckle - Swagger and Swagger UI Configuration

For more information on Swashbuckle.AspNetCore, check out their GitHub.

Settings

Mark non-nullable fields as required

Default setting: enabled

Controls whether or not non-nullable properties cause "nullable": true to be added to them in their generated schema.

Use simple schema identifiers

Default setting: disabled

By default, schema identifiers have been configured to be the fully qualified type name so as to avoid conflicts with otherwise identically named types. When this option is enabled "simple" identifiers without a namespace are generated instead.

Inclusion of XML documentation comments

To enable inclusion of XML documentation comments, ensure that in the Visual Studio designer, Generate Documentation File is set to true for both the <ApplicationName>.Api and <ApplicationName>.Application projects. It is also recommended on these projects to append ;1591 to the Suppress Warnings property so as to prevent generation of Missing XML comment for publicly visible type or member 'Type_or_Member' warnings.

Related Modules

Intent.Intent.AspNetCore.Swashbuckle.Security

This module introduces Authentication related patterns to this module.