api - ベスト プラクティス: 異なる API バージョンの複数のブランチまたは単一のブランチ

Question

API のバージョン管理をどのように管理するかについては、まだ設計中です。現在のところ、2 つのオプションがあります。

• 同じブランチ内のすべてのバージョン
  • 欠点: すべてのバージョンが、新しいコミットの影響を受ける可能性のある同じコア ライブラリを使用している可能性があります。古いバージョンではコード フリーズはありません。
• バージョンごとに異なるブランチ
  • 短所：メンテナンスに関しては、多くのブランチを管理することは悪夢かもしれません

より良い方法でそれを行う他のオプションはありますか、それとも上記のいずれかを続行する必要がありますか?

Answer 1

API ごとに個別のリリース ブランチをお勧めします。リリース ブランチから離れた古いバージョンのバグ修正を行うことができます。

API のバージョンを多数持つべきではありません。これが Web API の場合、破壊的でない変更には新しいバージョンは必要ありません。これがプログラミング言語 API の場合、各メジャー リリースはブランチである必要があり、マイナー リリースはタグとして、またはリリースからのサブブランチになります。