<summary> xml annotation not working for properties in nested objects

Assuming we have a model called Group that looks like this:

    public class Group{
      ///<summary>
      /// Some description of GroupName
      ///</summary>
      public string GroupName{get;set;}
      public List<Person> People {get;set;} 
    }

and a Person class that looks like this:

    public class Person{
      ///<summary>
      /// Some description of Name
      ///</summary>
      public string Name{get;set;}
    }

If we then use the ResponeType attribute for an API action and set it to typeof(Group) the resulting documentation for the action will only show the descriptions in the

element for the top level properties (GroupName, for ex). The description in the

element of the nested Person class (for Name) is not reflected in the generated documentation.

[luboshl]

I am using version 5.6.0 and multiple XML docs works for me:

var dir = new DirectoryInfo(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "bin"));
foreach (var fi in dir.EnumerateFiles("*.xml"))
{
    c.IncludeXmlComments(fi.FullName);
}

[lonix1]

@luboshl’s solution works in aspnet core 5:

var dir = AppContext.BaseDirectory;
var paths = Directory.GetFiles(dir, "*.xml", SearchOption.TopDirectoryOnly);
foreach (var path in paths) o.IncludeXmlComments(path);

@domaindrivendev Should be added to the docs, this issue is the only place it’s discussed.