我们正在升级大量的.Net代码,这些代码是在XML注释出现之前创建的。此代码包含大量注释,这些注释直接位于适用的代码成员之上:
' This property returns true if ...,我们希望通过XML注释来公开这些信息。但是,我们只能通过以下方式手动转换这些注释:首先插入xml注释模板(直接在成员上方键入‘’),然后在旧注释之前添加XML注释指示符(‘’
the tree to the first parent that is of the type XMLElement // remove the node the diagnostic firednode is not directly preceded by the comment marker node,
当提供同一方法的多个重载时,我通常不得不重复对该方法的描述,这违反了干燥,增加了维护成本:/// Frobnicates all foos read from the given reader. Frobnication is a/// </summary>void FrobnicateFoo(TextRea