大多数写开发文档,最开始我们选择了 ShowDoc 项目来作为文档管理工具。
随着团队的壮大,前后端分离,团队分工的细化,仅仅采用 Markdown 开始变得捉襟见肘,想到了使用开源界比较流行的 Swagger 来创建开发文档。
Swagger也是不够的,它只适应于API文档的管理,还有很多其它文档,比如设计构想,流程图,架构文档,技术方案,数据库变更等各种文档需要一起维护起来。因此,我决定利用业余时间开发一款 集成 Markdown 和 Swagger 文档的管理工具,也就是 Wizard 项目了。
Wizard 项目采用了 Laravel 开发框架开发,目前框架的版本已经升级到最新的 5.8,利用 Laravel 提供的各种组件,比如 Authentication,Authorization,Events,Mail,Notifications 等,非常适合Laravel新手利用该项目来学习Laravel开发框架。