您對 SwaggerHub 了解多少？
無論您是專家還是新手，您可能對您的團隊如何使用該平台以及更廣泛的 API 設計實務都有獨特的見解。
我們喜歡我們的使用者一起工作並互相幫助。我們非常重視社群。為了證明這一點，這個月我們正在舉辦一個名為「九月中心動態」的社群活動。
我們將每週在我們的社群論壇中獎勵最佳發文者免費禮品卡。我們希望了解您在使用 SwaggerHub 的過程中獲得了哪些知識，以及您如何幫助他人。
如何加入？
如果您已在 SmartBear 社群中註冊，那麼您所要做的就是發文。如果您是社群新手，只需註冊、建立使用者名稱，然後加入樂趣。
您不必是經驗豐富的使用者才能獲勝。參與和學習才是關鍵。無論如何，展現您的技能或熱情，您這週就有機會贏得禮品卡。或者只是獲得同儕的尊重。
這是一個雙贏的局面。
規則
因為總要有一些規則
- 活動期間 - 2019 年 9 月（9 月 2 日至 27 日）
- 要參與該計畫，您必須擁有 SmartBear 社群帳戶
- 活動在 SwaggerHub 社群中進行： https://community.smartbear.com/SwaggerHub
- 除了 SmartBear 員工外，任何 SmartBear 社群成員都可以成為贏家
- 每週將選出獲勝者：每週一將公佈前一週的獲勝者
- 發文數量最多的前 3 名成員最有資格贏得 SmartBear 的獎勵
| 第一名 |
50 美元禮品卡 |
| 第二名 |
35 美元禮品卡 |
| 第三名 |
15 美元禮品卡 |
只有有用的文章才會被計入以決定獲勝者。寫一些類似「我也要這麼說！」之類的話很好且支持，但不算是有用的文章。
所以，開始對話、加入對話或回答問題吧。在那裡見！
從回答問題開始
您在建立 API 文件時的「必備」原則是什麼？