APIライフサイクル管理のための新しいSaaSツールであるSwaggerHubは、人気のSwaggerHub製品にリアルタイムコメント機能をリリースしました。共有コンポーネント（SwaggerHubドメイン）とGitHubコード同期に加え、SwaggerHubはAPI定義上で直接コミュニケーションとコラボレーションを容易に実現します。
人々がグループで作業するときに創造性が生まれ、コミュニケーションがグループの成功の鍵となります。優れたコミュニケーションは、ワークスペース内の共有知識を最大化し、開発の高速化と同期の向上を可能にします。
SwaggerHubチームは、最新機能であるSwaggerHubコメントで、API構築においてこの精神を体現したいと考えています。
この新機能により、ユーザーはSwaggerHubエディター上で直接、API構築に関するアイデアを議論し、チーム内で意見を共有できるようになります。つまり、この機能により、ユーザーはSwaggerHubエディター上のAPI記述の特定の行にコメントを付けたり、それらのコメントに返信したりできるようになります。これにより、APIエディター自体でチームと対話し、API設計に関するフィードバックを得て、新しいAPIプロジェクトについて検討できるようになります！
仕組みは？
Swaggerコメントは、APIとドメインのチケットとして機能し、プロジェクトの利害関係者に問題やアイデアを提示します。まず、APIとドメインの右上にある共同編集者を追加することから始めましょう。
Swagger仕様に開発者を追加したので、コメントを介して彼らと対話できます。新しいコメントバーを使用して、APIおよびドメイン仕様にコメントを追加および表示できます。Swagger仕様の各行の左側にある「+」ボタンをクリックして、コメントバーからSwaggerコメントを追加します。
コメントバーには、解決済みと未解決の両方のAPI仕様に関するすべてのコメントが、行ごとにソートされて格納されています。Swagger UIからいつでもコメントバーにアクセスできます。このスペースをチームの記録係と見なし、共同編集者がAPIプロジェクトで見つけたすべての提案、質問、または問題を追跡します。「コメントを表示」をクリックすると、コメントバーが表示されます。
共同編集者は、Swagger仕様の任意の行にSwaggerHubコメントを追加、返信、解決、再開できます。最高の部分は、これらのコメントがリアルタイムで更新されるため、チームが何を言っているかを確認するために面倒なページ更新を行う必要がないことです。
SwaggerHubにアクセスして、詳細を確認してください！