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