Para documentar metodos en .NET es comun utiliar comentarios XML, mediante los cuales se puede generar documentacion externa usando herramientas como DocFX o Sandcastle.
Esto permite que tu API o biblioteca tenga una descripcion completa de cada método.
Ejemplo de comentario
public class ProductsController : ControllerBase
{
/// <summary>
/// Get a specific product by its ID.
/// </summary>
/// <param name="id">The ID from the product to retrieve</param>
/// <returns>Returns the product if it's found. Otherwise it returns HTTP 404.</return>
/// <response code="200">If the product is found.</response>
/// <response code="404">If the product is not found.</response>
[HttpGet("{id}")]
public IActionResult GetProductById(int id)
{
var product = // get product from a service
if(product is null)
{
return NotFound();
}
return Ok(product);
}
}