SwaggerHub 是一款用于 API 生命周期管理的新 SaaS 工具,刚刚为其热门产品 SwaggerHub 发布了实时评论功能。除了共享组件(SwaggerHub 域)和 GitHub 代码同步功能外,SwaggerHub 现在还可以轻松地直接在 API 定义上进行沟通和协作。
当人们以团队形式工作时,创造力会蓬勃发展,而沟通是团队成功的关键。良好的沟通能最大限度地共享工作空间中的知识,从而实现更快的开发和更好的同步。
SwaggerHub 团队希望在构建 API 时秉承这种精神,并通过最新功能——SwaggerHub 评论!
这项新功能允许用户直接在 SwaggerHub 编辑器上讨论想法并分享他们关于团队构建 API 的思考。简而言之,该功能使用户能够在 SwaggerHub 编辑器上对 API 描述的特定行进行评论和回复。这意味着您现在可以在 Swagger 编辑器上与您的团队互动,获取 API 设计的反馈并讨论新的 API 项目!
工作原理?
Swagger 评论充当您 API 和域上的“工单”,将问题和想法提请项目相关方注意。让我们从添加协作者开始,您可以在 API 和域的右上角找到该功能。
现在您已经在 Swagger 规范中添加了一些开发者,您可以通过评论与他们互动。您可以使用新的评论栏在您的 API 和域规范上添加和查看评论。点击 Swagger 规范每行左侧的“+”按钮,即可从评论栏添加您的 Swagger 评论。

评论栏包含 API 规范上的所有评论,包括已解决和未解决的,按行排序。您可以随时从 Swagger UI 访问评论栏。将此空间视为您团队的记录员,跟踪您的协作者在您的 API 项目中发现的所有建议、问题或事项。点击“显示评论”可查看评论栏。
协作者可以在 Swagger 规范的任何行上添加、回复、解决和重新打开 SwaggerHub 评论。最棒的是,这些评论会实时更新,因此您无需进行那些恼人的页面刷新来查看团队的反馈。
前往 SwaggerHub 获取更多信息!