API文档工具swagger-简单说
现在的网站架构基本都由原来的后端渲染，变成了：前端渲染、先后端分离的形态，
前端和后端的唯一联系，变成了API接口；API文档变成了前后端开发人员联系的纽带，变得越来越重要，swagger就是一款让你更好的书写API文档的框架。
API文档工具前世今生
没有API文档工具之前，大家都是手写API文档的，在什么地方书写的都有，有在confluence（wike）上写的，有在对应的项目目录下readme.md上写的，
高端点的还有用阿里的RAP
github地址为：https://github.com/thx/RAP
部署文档https://github.com/thx/RAP/wiki/deploy_manual_cn
swagger
rap挺好的，但是和swagger比起来有点轻量。
下面再细看看swagger的生态的具体内容：
swagger-editor
就是一个在线编辑文档说明文件（swagger.json或swagger.yaml文件）的工具，以方便生态中的其他小工具（swagger-ui）等使用。
左边编辑，右边立马就显示出编辑内容来。
编辑swagger说明文件使用的是yaml语法
swagger-codegen
代码生成器，脚手架。可以根据swagger.json或者swagger.yml文件生成指定的计算机语言指定框架的代码。