【发布时间】:2013-11-13 09:19:05
【问题描述】:
我找到了很多方法来为 Web 服务(doxygen、SandCastle 等)生成文档,但我似乎找不到我真正需要的东西。
我们有一个用 C#.NET 编写的 Web 服务,我使用标准 XML 文档(摘要标签等)记录了其中的所有公共方法。
我想找到一种方法来生成使用文档,而不是生成有关项目设置方式的文档。我不需要将所有内部类和方法都包含在文档中。 唯一应该包括的是标有 [OperationContract] 的公共方法及其文档。
我发现使用 Sandcastle 我可以限制这些类和方法,所以这是一个开始。但是,我们希望将文档传递给其他不一定使用 .NET 的开发人员,因此最好有一个生成的示例,以准确地进行 SOAP 调用等。
你能告诉我这是否可以使用 Sandcastle 来完成,还是我应该使用不同的方法?
【问题讨论】:
标签: c# wcf web-services documentation-generation sandcastle