XML Documentation

The JsonSchemaGenerator automatically loads .NET XML Documentation files to populate for example the Swagger attributes summary or description. The XML file is searched in the same directory as the assembly with the same file name as the assembly but with the file extension .xml.

The XML Documentation reader uses reflection to support multiple platforms in a single PCL. In order to work, the following types must be available:

• System.IO.File
• System.IO.Path
• System.Xml.XPath.Extensions

.NET Core

To make the required types available in a .NET Core process (i.e. in your ASP.NET Core application), you need to install the following NuGet packages:

• System.IO.FileSystem
• System.Xml.XPath.XDocument