• 项目开发效率怎么提高——围绕API接口文档


    通过API文档驱动开发流程

    最近和同行交流时也听到一个观点:采用“文档驱动”的协作模式,比“先开发、后维护文档”和“口头沟通确认”的方式,团队协作效率和产品质量都能得到提高。
    因此在了解后,最近项目组找了个工具,尝试基于文档来进行工作,使用有章可循的 “文档驱动” 方式来降低大量无意义的沟通成本。

    使用Eolinker进行开发协同工作

    在Eolinker 中,我们几乎所有的协作工作都是围绕着 API接口文档进行的。创建了 API 文档之后,所有人都可以随时查看 API 的改动情况,根据 API 文档发起 API 测试,编写 API 测试用例,创建 Mock API,进行 API 自动化测试等。
    使用地址:www.eolinker.com

    为 API 设置合适的状态为 API 设置合适的状态

    Eolinker将 API 的状态划分为以下几种,方便成员在查看 API 文档时了解 API 当前所处的状态。
    已发布:API 已发布,可正常使用
    设计中:等待或正在设计 API
    待确定:API 已设计完成,等待相关成员确定 API 的内容
    开发:API 已确定内容,等待或正在开发
    对接:API 已开发完成,等待或正在对接
    测试:API 已对接完成,等待或正在测试
    完成:API 已测试完成,等待发布
    异常:API 出现异常,需要尽快排查
    维护:API 维护或升级中
    废弃:API 已废弃,不可正常使用

    为 API 设置变更通知为 API 设置变更通知

    可以通过变更通知功能,设置当 API 状态或者内容改变时自动通过站内信或者邮件等方式通知相关的成员。

    对 API 发表评论对 API 发表评论

    你可以通过API 评论功能,直接在 API 文档上发布评论,所有的沟通内容都会跟随 API 文档保留下来并且按照版本分类好,而不是零散地存在各种聊天工具中。

    了解和对比 API 的变更历史了解和对比 API 的变更历史

    如果想了解 API 当前版本更新的内容,可以直接查看 API 的编辑历史,对比当前版本和历史的某个版本的差别。或者是回滚到历史上的任何一次编辑,查看历史版本的详细内容。

  • 相关阅读:
    yarn : 无法加载文件 C:\Program Files\nodejs\node_global\yarn.ps1,因为在此系
    各种本地k8s运行总结对比
    K3S运行完整示范kubeexplorer、kubeapps
    使用python拆分PDF
    MyBatis 及 MyBatis Plus 纯注解方式配置(Spring Boot + Postgresql)
    HTTP/2 中的帧定义
    Nginx 面试40问 ( 收藏吃灰 )
    时序攻击(timing attack)
    使用 Playwright 进行 E2E 测试
    单元测试
  • 原文地址:https://www.cnblogs.com/dc20181010/p/13977642.html
Copyright © 2020-2023  润新知