SwaggerHub 是一種用於 API 生命周期管理的新 SAAS 工具,它剛剛為熱門的 SwaggerHub 產品發布了即時評論功能。除了共享元件 (SwaggerHub 網域) 和 GitHub 程式碼同步之外,SwaggerHub 現在還可以讓您輕鬆直接在 API 定義上進行溝通和協作。
當人們以群組方式工作時,創意就會蓬勃發展,而溝通是群組成功的關鍵。良好的溝通可以最大限度地提高工作區中的共享知識,從而加快開發速度並實現更好的同步。
SwaggerHub 團隊希望在建置 API 時體現這種精神,因此推出了最新的功能:SwaggerHub 評論!
這項新功能允許使用者直接在 SwaggerHub 編輯器上,針對團隊中的 API 建置,討論想法並分享他們的想法。簡而言之,此功能讓使用者可以在 SwaggerHub 編輯器上,針對 API 描述的特定行進行評論和回覆。這表示您現在可以與您的團隊互動,取得有關 API 設計的回饋,並在 Swagger 編輯器本身討論新的 API 專案!
運作方式為何?
Swagger 評論就像您 API 和網域上的工單一樣,將問題和想法帶給您的專案利害關係人注意。首先,從您的 API 和網域的右上角新增協作者。
現在您已在您的 Swagger 規格上新增了一些開發人員,您可以透過評論與他們互動。您可以使用新的「評論列」在您的 API 和網域規格上新增和檢視評論。按一下 Swagger 規格每一行左側的 `+` 按鈕,即可從「評論列」新增您的 Swagger 評論。

「評論列」包含 API 規格上所有已解決和未解決的評論,並依行排序。您可以隨時從 Swagger UI 存取「評論列」。將此空間視為您團隊的記錄管理員,追蹤您的協作者在您的 API 專案中找到的所有建議、問題或議題。按一下 `顯示評論` 會顯示「評論列」。
協作者可以在 Swagger 規格的任何行上新增、回覆、解決和重新開啟 SwaggerHub 評論。最棒的是,這些評論會即時更新,因此您不需要執行那些惱人的頁面重新整理,即可查看您團隊的想法。
前往 SwaggerHub 以取得更多資訊!