0
APIの安定性の指標はAPIドキュメントでは重要ですが、現在私はSwashbuckleを使ってASP.NET Web APIで構築されたAPIをドキュメント化しています。 "安定"、 "凍結"などのAPI安定性指標を持つAPIにフラグを立てます。SwaggerでAPIの安定性をフラグする方法はありますか
APIの安定性の指標はAPIドキュメントでは重要ですが、現在私はSwashbuckleを使ってASP.NET Web APIで構築されたAPIをドキュメント化しています。 "安定"、 "凍結"などのAPI安定性指標を持つAPIにフラグを立てます。SwaggerでAPIの安定性をフラグする方法はありますか
OpenAPI/SwaggerにはAPI安定性を示すフィールドはありませんが、vendor extensionを使用してそれを記録できます安定性指数)。
私はあなたが選択したバージョン番号がSEMVERに制限されたり、他のではないことを追加される場合があります。多くの人が '-alpha'、' -beta'などでバージョンをサフィックス化し、リリース版ではないことを示します。 – fehguy