c# - ¿Cómo genero documentación API para SignalR?

swashbuckle code-documentation

Question

¿Hay alguna forma de hacer esto?

Tengo swashbuckle generando contenido para mis otras API, pero no creo que funcione para SignalR.

Answer 1

Suponiendo que está utilizando Asp.NET Core, la documentación personalizada se puede inyectar en el momento del inicio.

En tu Startup.ConfigureServices ya deberías tener una sección Swagger:

services.AddSwaggerGen(c =>
{
    ...
})

Solo agrega un archivo XML personalizado a la documentación de Swagger:

services.AddSwaggerGen(c =>
{
    c.IncludeXmlComments("custom_doc.xml");
})

donde custom_doc.xml es un archivo de documentación XML estándar de C #.