是否可以为ServiceStack创建的REST API自动生成好的文档？

Question

现有用于自动生成API文档的工具 - 大部分都不是为REST服务设计的。

对于使用ServiceStack创建REST服务的所有人 - 您是如何编写文档的？ 手动/半自动/全自动？ 我甚至考虑自动生成一个定制的WADL并将其连接到像apigee Console To Go

这样的东西

（哦和RESTafaries-请多说'REST api应该是可自动发现和自我解释'的口头禅......我真的希望为我的用户提供漂亮的文档。

Answer 1

通过XHTML记录API可能比格式化DTO提供更好的结果。看看http://www.amundsen.com/blog/archives/1043和鼓舞人心的video。