You use Swagger, and include XML comment files, which are copied during build from a few different projects to the root of your API application. Then one day, you realize that the build didn’t copy one of the XML files, so this line threw an exception:
options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "MyProject.Domain.xml"));Yes, you can fix the build to resolve the error, but if you treat XML comments as content (not code), you can do this:
foreach (var file in Directory.GetFiles(AppContext.BaseDirectory, "*.xml"))
{
options.IncludeXmlComments(file);
}It appears that Swagger doesn’t break when a non-XML comment file are included, which is beneficial. With this method, only XML files that exist are included, you don’t risk breaking your app when they are missing.