rest - 是否可以为 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和这个鼓舞人心的视频。