title: C# swagger documentation for individual members of the request body object
body: <p>We are writing swagger documentation using /// comments in the following way:</p>
  
  <pre><code>/// &lt;summary&gt;
  /// Create a new widget
  /// &lt;/summary&gt;
  /// &lt;param name="widget"&gt;&lt;/param&gt;
  [HttpPost("/create")]
  [ProducesResponseType(typeof(IPayment), 200)]
  [ProducesResponseType(typeof(ErrorResult), 400)]
  [ProducesResponseType(typeof(ErrorResult), 404)]
  public Task&lt;IActionResult&gt; CreateWidget([FromBody] Widget widget)
  {
  </code></pre>
  
  <p>Now Widget is an implementation of IWidget and the user of the documentation should know in detail what each data member of Widget / IWidget means, what's mandatory, what's optional, and valid values.</p>
  
  <p>We found that the only place to add this description is in </p>
  
  <pre><code>/// &lt;param name="widget"&gt;very big multi line description&lt;/param&gt;
  </code></pre>
  
  <p>While this works for the end user, is there a better way? We ask this because it is much more maintainable if the descriptions are provided inline in the class / interface definition.</p>