我有几个 C# 项目以及一些内部库组件，我正试图一起记录它们。 Sandcastle 似乎是从 C# 生成文档的地方。我想知道 DocProject 或 Sandcastle Help File Builder GUI 两者中哪一个更好，并且支持我需要的功能。
我想只编译每个项目自己的文档部分，然后最后将它们全部集成在一起。 （即一个文档项目中的库组件和它自己的文档项目中的每个项目，然后使用 Help 2 查看器将上述所有内容放在一个根目录中）
【问题讨论】：
标签： c# sandcastle
我可以担保 Sandcastle Help File Builder。它工作得非常好，您可以在 Sandcastle Help File Builder 项目中记录任意数量的程序集。理论上，您可以拥有一个 Builder 项目并为每个 C# 项目生成一个文档，然后拥有一个主 Builder 项目来记录所有内容。
【讨论】：
以下是基于 Sandcastle 的 .NET 文档的一些有用链接：
Sandcastle Help File Builder (SHFB)
Tutorial on SHFB
Web Project Documentation
Tutorial on how to document Web Projects（更多手册，我相信之前的链接已经过时）
【讨论】：
Doc Project 生成更精美的文档 - 当它工作时 - 并非一直如此。这是一个更加脆弱的产品。
Sandcastle 帮助文件生成器很可靠，可以完成工作。
【讨论】：
我没有使用过 DocProject，但它似乎是一款功能可与 Sandcastle 相媲美的产品。
我使用过Sandcastle，我发现它是一个有效的工具。正如其他人在这里提到的那样，您还需要Sandcastle Help File Builder (SHFB) 来为您提供良好的前端。此外，您需要Sandcastle Styles 来获取 Sandcastle 引擎的表示层补丁。虽然所有这三个组件都在 2010 年中期发布了新版本，但由于 Firefox 3.6 中的呈现缺陷（在此 defect report 的 2010.09.06 条目中记录），我将推迟从 2008 版本升级。
我已经彻底记录了我在描述该问题的平台方面的经验，以及您可能需要或想要考虑的各种其他问题，以便生成整洁、专业的文档集。我的文章“Taming Sandcastle: A .NET Programmer's Guide to Documenting Your Code”刚刚于2010年9月发表在Simple-Talk.com；它可能会为您节省一些时间、精力和痛苦:-)。
【讨论】：