共计 1663 个字符,预计需要花费 5 分钟才能阅读完成。
大家好,时隔一个月,咱们又又又公布啦,本月的主题是:团队合作。
在开发模式是前后端合作的团队里,分享 API 文档信息会是前后端对接过程中重要的一环,我想在这次月报分享下咱们工具举荐的开发流程。
知乎上有一个热门问题:后端人员先开发后给文档正当吗?
我认为不合理,换位思考了下在这种开发模式下的前端人员,对接的过程应该蛮苦楚,前端开发的能力和教训决定后续改变代码的苦楚水平。
波及到多人独特合作实现一件事的时候,不应该把设计工作只交给其中的某一个人,应该先交换和沟通,将设计的流程前置,并用文档记录设计的过程和后果。
就像开发人员总会吐槽产品文档没写分明一样,前端人员也会吐槽后端不给文档或者写不分明,这个问题能够通过引入一个能合作设计并展现清晰的 API 信息的工具(明示 Eoapi)解决。
你能够思考在 Eoapi 尝试采纳以下繁难的合作流程:
- 设计接口原型,写接口文档;
- 前后端同步写代码,依据文档对接;
- 在对接过程中取得的信息优化接口原型,反复过程。
更直观一些,两种合作流程的对比方图:
其实工作都是这些工作,但将设计的过程提前能够缩小很多合作问题。
敌人们,置信我,想通过不写文档节俭的工夫最终都会在对接扯皮过程中还给咱们;而且人多力量大嘛,不同的人有不同的角度,观点碰撞能够让设计更好更全面。
当然,决定在设计过程中投入多少工夫和精力是须要依据团队的状况调配的,团队很有默契不必约定也能设计统一,那文档什么时候写就不太重要了,适宜本人团队的流程就是最好的。
空间是什么?
咱们在这个版本引入了空间的概念,一个空间个别是一个团队,咱们能够往空间里增加队友:
退出后就能够一起欢快地共享 API 和环境等空间内数据啦~
想起在月初的时候,有用户恳(wei)请(xie)咱们肯定肯定肯定不要做登录的性能,我了解他的外围的诉求其实是关上就能用,别整那么多花里胡哨的。
作为 Eoapi 的产品和开发我想说:释怀吧,如果你用不上云端的性能,那就没有登录的必要,在本地空间内纵情应用吧~
如何应用
在服务端运行上面命令应用 Docker 一键启动。
git clone https://github.com/eolinker/eoapi-remote-server
cd eoapi-remote-server
docker-compose up -d --build
在客户端中配置云服务地址点击连贯后就能够将数据上传到云端啦。
配置这一块咱们设计得非常简略,暗藏了很多配置细节,界面提醒能够指引你疾速上手新性能。例如初始化时能够让你抉择将本地的数据同步到云端。
后续打算
Web 部署
目前咱们都是通过桌面端应用的,有的用户会感觉部署和更新不太不便。
所以咱们接下来会推出 Web 版本,不便大家关上浏览器就能应用(我集体更喜爱 Web 利用)~其实桌面端有桌面端的益处,不便找,加载快,不须要部署,萝卜青菜各有所爱。
API 分享
正在开发中,置信很快就能在 v1.9.0 和大家见面啦。
应用很简略,一键就能够通过分享链接疾速将 API 分享给相干的人员。原型图浅看一下:
取得 GVP
除了新版本公布,还有一个好消息!本月咱们的 开源我的项目终于也取得了 Gitee 官网的认可 , 荣获 Gitee 年度最有价值的开源我的项目名称——GVP,谢谢官网的认可!谢谢各位用户的反对!
致力晋升用户体验是咱们做开源我的项目的初心 ,只管咱们的我的项目在 Gitee 上传代码不久,但为了让所有用户能有较好的下载体验, 咱们会在后续任何一个新版本公布的第一工夫同步 Gitee。
咱们会致力做好我的项目,也心愿咱们的我的项目能持续失去你们的大力支持!对于我的项目,如果你有任何的疑难或者倡议,老规矩,记得去 Github 或者 Gitee 上提 Issue,咱们会第一工夫解决。
在线 Demo:https://www.eoapi.io/?utm_sou…
在线文档:https://docs.eoapi.io/?utm_so…
Github:https://github.com/eolinker/e…
Gitee:https://gitee.com/eolink_admi…