
课程咨询: 400-996-5531 / 投诉建议: 400-111-8989
认真做教育 专心促就业
开发文档对于每一个程序员来说应该都不陌生的吧,而且提前准备开发文档能够让软件开发项目有一个明确的流程,下面我们就一起来了解一下,软件开发文档编辑工具都有哪些。
1、为什么开发插件
每次在对外提供接口时都要写文档,各种麻烦,并且文档耗费了很大一部分时间。也使用了一些文档工具,在线写作工具,终还是比较喜欢自己手写文档。
2、使用过的生成工具
Swagger:添加依赖,配置类及描述信息,然后在方法及实体上添加注解,启动项目便可以通过访问xxxx/swagger-ui.html查看接口文档;
APIDoc:添加配置文件及注释,安装npm并通过执行命令生成文档;
SmartDoc:添加依赖及注释后执行测试类生成文档;
API2DOC:添加依赖,开启注解,通过注解配置生成文档。
上面四种方法,无疑都需要添加依赖,使用注解等方式,可以说有一定的代码侵入性。
3、使用过的接口文档工具
ShowDoc:曾经一段时间很喜欢用这个,Markdown语法,方便直观。不过就是要自己手写;
YApi:现在在使用YApi,可以通过Swagger导入;
VSCode写Markdown:直接离线写Markdown,可以导出PDF、Word、Html。
自己写文档比较重复,繁琐,不过个人比较喜欢Markdown格式。简洁直观。并且配合着我之前写的IDEA插件copy-as-json和Tookit将实体复制为json字符串,用来快速生成请求样例和返回样例,还是可以减少一定的工作量的。
4、其他使用方式
使用各种在线协作工具,腾讯文档、语雀、石墨文档。使用离线版本PDF、Word、Excel等等。也有一些其他的文档工具,不过自己都没有使用过或者调研过了。
基本上这些文档工具要么通过代码侵入的方式生成文档,要么自己手撸文档。总体来说各有千秋。
【免责声明】本文系本网编辑部分转载,转载目的在于传递更多信息,并不代表本网赞同其观点和对其真实性负责。如涉及作品内容、版权和其它问题,请在30日内与管理员联系,我们会予以更改或删除相关文章,以保证您的权益!更多内容请在707945861群中学习了解。