是否有用于评论C#代码的标准(如phpdoc或python的docstring)？

是否有标准约定(如phpdoc或python的docstring)用于注释C#代码,以便可以从源代码自动生成类文档？

您可以使用XML样式注释,并使用工具将这些注释提取到API文档中.

以下是评论样式的示例:

/// 

/// Authenticates a user based on a username and password.
/// 
/// The username.
/// The password.
/// 
/// True, if authentication is successful, otherwise False.
/// 
/// 
/// For use with local systems
/// 
public override bool Authenticate(string username, string password)

一些便于此的项目是:

GhostDoc,它提供一个快捷键来自动为类或方法生成注释. Sandcastle,从XML注释生成MSDN样式文档.