ASP.NET MVC控制器中的方法似乎没有XML记录吗？

Question

我是一个巨大的.NET XML文档的风扇.

但是,我可以诚实地说,我从未见过教程或项目,例如,我们有这样的标记:

/// <summary>
/// dummy text
/// </summary>
/// <returns>blah</returns>
public ActionResult LogOff() {
    FormsService.SignOut();

    return RedirectToAction("Index", "Home");
}

代替:

// **************************************
// URL: /Account/LogOff
// **************************************

public ActionResult LogOff() {
    FormsService.SignOut();

    return RedirectToAction("Index", "Home");
}

这有什么特别的原因吗？我是唯一一个想要记录我的Controller方法的人吗？

编辑1:

虽然大多数控制器方法看起来很简单,但详细说明的问题如何说明这个问题:MVC:如何使用具有许多子实体的实体？？

Answer 1

当需要为使用它的外部各方记录公共API时,XML文档非常有用.在我看来,控制器不属于那个类别.

同样与超薄控制器一致,他们应该自我解释他们做什么,特别是对于属性元数据,如HttpPost和HttpGet.

您是否设想使用控制器作为API的第三方？