C# VisualStudio与DoxyGen一起提供文档，还是应该使用其他工具？_C#_Visual Studio_Documentation

C# VisualStudio与DoxyGen一起提供文档，还是应该使用其他工具？

c# visual-studio documentation

C# VisualStudio与DoxyGen一起提供文档，还是应该使用其他工具？,c#,visual-studio,documentation,C#,Visual Studio,Documentation,我们目前正在使用DoxyGen来记录用C/C++、PHP和Java编写的代码。为了拥有一个一致的环境，最好也将其用于C#文档然而，我们想知道：您认为使用DoxyGen以外的工具生成的文档布局或结构有什么优势吗？我们正在为有C#和.NET平台经验的外部开发人员生成文档。也许他们习惯了某种文档格式 DoxyGen与Visual Studio的集成程度如何？是否有某种东西可以从IDE内部一键生成文档其他文档系统是否与VisualStudio更为集成 Visual Studio没有集成的文档系统

我们目前正在使用DoxyGen来记录用C/C++、PHP和Java编写的代码。为了拥有一个一致的环境，最好也将其用于C#文档

然而，我们想知道：

您认为使用DoxyGen以外的工具生成的文档布局或结构有什么优势吗？我们正在为有C#和.NET平台经验的外部开发人员生成文档。也许他们习惯了某种文档格式
DoxyGen与Visual Studio的集成程度如何？是否有某种东西可以从IDE内部一键生成文档
其他文档系统是否与VisualStudio更为集成

自由微软之路。使用DocXml文档注释，然后使用Sandcastle或类似工具构建MSDN样式的文档。这样做的好处是VisualStudio可以识别文档（对注释进行语法着色），并且Intellisense系统会立即拾取文档（因此，如果您将鼠标指针悬停在正在调用的方法上，工具提示将显示您在文档注释中输入的摘要和参数信息）
自由氧系统。这更易于使用和更灵活，但Visual Studio不支持，因此您失去了智能感知和语法着色的优势。另一方面，Doxygen确实解析DocXml格式，因此您可以通过将DocXml格式与Doxygen一起使用来生成外部帮助，从而充分利用这两个方面
商业产品，如DocumentX，允许您在所见即所得窗口中编辑文档

//

/// <summary>
/// 
/// </summary>
/// <param name="bar"></param>
private void Foo(int bar)
{
    // ...
}

//
/// 
/// 
/// 
专用void Foo（整型条）
{
// ...
}

总而言之：