二十五年的折腾：.NET 工程文档开源工具的沉浮
💡
原文中文，约4600字，阅读约需11分钟。
📝
内容提要
随着AI的兴起，技术文档再次受到重视。尽管Lunet工具可以生成API文档，但其定制性不足。回顾.NET文档工具的发展历程，从NDoc到Sandcastle，再到DocFX，开发者面临生态分裂和信任问题。新项目dotnet-sphinx旨在连接.NET与Sphinx，提供更灵活的文档生成解决方案。
🎯
关键要点
- 随着AI的兴起，技术文档重新受到重视，Lunet工具生成API文档但定制性不足。
- 回顾.NET文档工具的发展历程，从NDoc到Sandcastle，再到DocFX，开发者面临生态分裂和信任问题。
- NDoc是一个早期的社区项目，但因无法跟上.NET Framework的变化而停滞不前。
- Sandcastle是微软推出的工具，虽然功能强大，但因早期未公开源代码而引发信任危机。
- DocFX是微软推出的新一代文档工具，但缺乏可视化界面和用户友好的主题，导致独立维护者不满。
- Lunet工具虽然方便，但在定制化方面表现不佳，开发者希望有更好的连接Sphinx的解决方案。
- dotnet-sphinx项目旨在连接.NET与Sphinx，提供灵活的文档生成解决方案，适应现代需求。
- 历史上，.NET文档工具的发展经历了生态分裂和优先级转移，开发者需寻找解决方案以应对挑战。
❓
延伸问答
Lunet工具的主要功能是什么？
Lunet工具主要用于生成API参考文档，但在定制性方面表现不足。
.NET文档工具的发展历程是怎样的？
.NET文档工具经历了从NDoc到Sandcastle，再到DocFX的演变，反映了生态分裂和信任问题。
为什么NDoc在.NET Framework 2.0发布后停滞不前？
NDoc无法支持.NET Framework 2.0中新增的泛型等特性，导致项目停滞。
Sandcastle工具的主要问题是什么？
Sandcastle最初未公开源代码，导致社区信任危机，并且在内存消耗方面表现不佳。
DocFX与之前的文档工具相比有什么优势？
DocFX支持Markdown输入，能快速集成到CI/CD管道，并对.NET特性有原生理解。
dotnet-sphinx项目的目标是什么？
dotnet-sphinx项目旨在连接.NET与Sphinx，提供灵活的文档生成解决方案。
➡️
