If the class is generic you must give description not only for generic arguments, but also for its own properties.
For example:
/// <summary>
/// API response status
/// </summary>
public enum Status
{
/// <summary>
/// Normal response
/// </summary>
Ok,
/// <summary>
/// Some fail
/// </summary>
Fail
}
public class ApiResponse<T>
{
/// <summary>
/// API response status
/// </summary>
public Status Status { get; set; }
/// <summary>
/// Response data
/// </summary>
public T Data { get; set; }
}
//Action attribute
[ProducesResponseType(StatusCodes.Status201Created, Type = typeof(ApiResponse<SomeClass>))]
Before this pull request you will not get description for Status enum property of the ApiResponse
If the class is generic you must give description not only for generic arguments, but also for its own properties. For example:
Before this pull request you will not get description for Status enum property of the ApiResponse