Open
Description
It's a bit of a hassle having to maintain both the ///
comments and the OpenApiOperation[]
annotation.
This is fair for the actual operations, but becomes more of a struggle with domain objects that are returned which may have lots of properties which are already documented properly in the documentation comments. Is it possible to somehow extract the <summary>
text and have it used by default?
public class Person
{
/// <summary>
/// Lorem ipsum dolor sit amet, consectetur adipiscing elit...
/// </summary>
[OpenApiPropertyDescription("Lorem ipsum dolor sit amet, consectetur adipiscing elit...")]
public string? FirstName { get; set; }
/// <summary>
/// Lorem ipsum dolor sit amet, consectetur adipiscing elit...
/// </summary>
[OpenApiPropertyDescription("Lorem ipsum dolor sit amet, consectetur adipiscing elit...")]
public string? LastName { get; set; }