记录F＃代码的最佳方法是什么？

Question

我尝试了Sandcastle，其中包含的GUI安装中包含的补丁程序，但是除非我做错了什么，但基本上不适合记录F＃代码（即使它对C＃非常有效）。也许它对他人有用，在这种情况下，我将非常感谢我可以从我开始的简短示例。非常感谢。

我知道 Sandcastle不会从F＃组装中输出所有内容 ，但是所引用的项目尚未准备好黄金时段。

肯定有一些可靠地工作并且“足够好”的东西吗？非常感谢您的建议。

编辑：非常感谢所有回答的人。布莱恩的回答最接近我想要的东西，所以我会接受的。但是，结果是，似乎没有一个适合F＃的解决方案，并且可以可靠地起作用。我现在会坚持文本评论。

我希望fshtmldoc.exe在某个时候开始工作。虽然我不能排除它已经起作用了，而且我只是没有正确使用它，但谷歌搜索表明我不是唯一发现它并不完美的人。

Answer 1

我几乎不知道Sandcastle，但是请注意，像C＃一样，在F＃中，您可以使用Triple-Slash注释，并且它们将在编译器输出的XML文档文件中输出（在VS中，在VS，在“项目属性”页面上，构建选项卡， ，检查“ XML文档文件”复选框；在命令行上，使用 --doc 争论 fsc.exe.)

另外，请参阅 FsHtmlDoc.exe 在里面 动力单元.

Answer 2

你也可以看 FOCCO

它产生了一个不错的基于HTML的文档。看 这里 例如：

Answer 3

你也可以检查一下 Apistack 从 Intellifactory. 。我意识到，如果您已经有大量标准XML文档评论，ROCCO需要一种非常不同的方法。

Answer 4

我没有使用过，但是可能值得给 Docu 尝试...