Wiki/Docs: .UseAllOfToExtendReferenceSchemas() Necessary?

[DaleyKD]

I couldn't get any of your stuff to output documentation unless I use the options.UseAllOfToExtendReferenceSchemas() from Swashbuckle. I don't know if this needs to be added to the docs or not. Just thought I'd give you an FYI.

services.AddSwaggerGen(options =>
{
    options.SwaggerDoc("v1", apiInfo);
    options.UseAllOfToExtendReferenceSchemas();

    var xmlFile = $"{Assembly.GetEntryAssembly()?.GetName().Name}.xml";
    var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
    if (xmlFile != ".xml" && File.Exists(xmlPath))
    {
        options.IncludeXmlComments(xmlPath);
    }

    options.AddEnumsWithValuesFixFilters(services, o =>
    {
        o.ApplySchemaFilter = true;
        o.ApplyParameterFilter = true;
        o.ApplyDocumentFilter = true;
        o.IncludeDescriptions = true;
        o.DescriptionSource = DescriptionSources.DescriptionAttributesThenXmlComments;
        if (xmlFile != ".xml" && File.Exists(xmlPath))
        {
            o.IncludeXmlCommentsFrom(xmlPath);
        }
    });
});

[unchase]

I use the options.UseAllOfToExtendReferenceSchemas() in my work project. You should use it if you want to hide Paths and Definitions from OpenApi documentation correctly.