Swagger-UI简单而一目了然。它能够纯碎的基于html+javascript实现，只要稍微整合一下便能成为方便的API在线测试工具。项目的设计架构中一直提倡使用TDD（测试驱动）原则来开发，swagger-ui在这方面更是能提供很大帮助。
Swagger-UI更倾向于在线测试接口和数据，但其核心是一个javascript插件，只要稍作修改，便能按需求定制出不同格式的说明文档，在github上更是基于它集成到各种语言环境，分支众多。
其官方提供了一个离线版本，它的使用方法十分简单：直接在js格式的资源文件中录入REST API的json信息，便能容易地生成不同模块下的API列表，每个API接口描述和参数、请求方法都能在每个json数组中定制。下面是目前项目中使用到的部分预览图：
Swagger-UI 的官方地址：
http://swagger.wordnik.com
Github上的项目地址：
https://github.com/wordnik/swagger-ui
官方提供的demo地址
http://petstore.swagger.wordnik.com/
------------------------------------------
2012年10月19日更新：
下面是自己目前修改后的demo：
1. 添加了window.swaggerUi 中的几个参数（说明文件），更方便资源文件的编写
2. 修复了测试时post方法的bug
3. 界面显示中文
4. 根据每个接口的更新情况，定制了一些修订说明
附件（swagger-ui-editby-ekin.zip）