現在， main ブランチがリリースブランチとなっている．
リリースには，本 Release と Pre-release の２つを設ける．
- 本 Release
- まとまった機能更新のリリース．
- バージョンを上げる．
v3.4.0→v3.5.0など
- Pre-release
- 主に， Tools/Overview などで非互換なアップデートが入った場合のリリース．
betaをリリースする．v3.4.0→v3.5.0-beta.0など
リリースの手順は以下のようにする．
- バージョン番号をインクリメントする PR (Pull Request) を発行し，
developブランチへマージする．- c2a_core_main.h 内の
C2A_CORE_VER_*をインクリメントする． - Cargo.toml 内の
package.versionをインクリメントする． - この後リリースを控えるので，念の為すべてのテストを再度回す．
#define C2A_CORE_VER_PREは("")とする．- PR 名は
Update version (v3.4.0)のようにする． - 例: https://github.com/ut-issl/c2a-core/pulls?q=is%3Apr+Update+version
- c2a_core_main.h 内の
- バージョン上げ PR がマージされたら，直ちに（他の PR を止め）
developからmainに PR を発行し，すべてのテストを回し，マージする．- PR 名は以下のようにする．
Update main (v3.4.0) on 2021-12-31Update main (v3.4.0) on 2021-12-31 - ほげほげ
- PR のディスクリプションは これ のように書く．
- 例: https://github.com/ut-issl/c2a-core/pulls?q=is%3Apr+Update+main
- PR 名は以下のようにする．
- tag を打ち， release を発行する．
- tag 名は
v3.4.0のようにする． - release 名は
v3.4.0やv3.3.1 初版のようにする． - release には以下を含める．
- Release Note として簡潔な更新差分の箇条書き
mainにマージしたときの PR のリンク
- tag 名は
cargo publishする．
これを，だいたい以下のような粒度で行う．
- 最後のリリースからおおよそ１ヶ月程度が経過した場合（更新が少ない場合を除く）
- まとまった機能実装が一段落した場合
ただし，あるまとまった機能の実装の PR が複数に分割され，一部がまだマージされていない場合はリリースを控えること．
- Tools/Overview などに非互換なアップデートが含まれる PR を発行する．このとき， Pre-release PR となる．
- これは，
featureブランチからdevelopブランチへの PR になるはず． - 対応する Tools の PR のリンクを貼る．
#define C2A_CORE_VER_PREに("beta.0")などをセットする．- 本 Release 後最初の Pre-release の場合，
C2A_CORE_VER_*をインクリメントする． - Cargo.toml 内の
package.versionを同様にインクリメントする． - PR 名は以下のようにする．
Pre Release (v3.5.0-beta.0): 通常のPRのタイトル
- 例: https://github.com/ut-issl/c2a-core/pulls?q=is%3Apr+Pre+Release
- これは，
- tag を打ち， release を Pre-release として発行する．
- tag 名は
v3.5.0-beta.0のようにする． - release 名は
v3.5.0-beta.0のようにする． - release には以下を含める．
- 非互換となった Tools の新しい バージョン (Release) へのリンク
developにマージしたときの PR のリンク
- tag 名は
cargo publishする．
なお，Bug fix や 大きな機能更新などで，本 Release 前に User サイドで最新の Core が必要になった際にも， Pre-release を行うことができる．
Semantic Versioning を採用する．
少なくとも， Tools/Overview の Tool に後方互換性のない更新があった場合は，新しいバージョンをリリースする．
Tool のリリースには，以下に注意する．
- C2A と同様の規則で Relase を発行する．
- release には以下を含める．
- Release Note として簡潔な更新差分の箇条書き
- 対応する最小 C2A Core バージョン
- この Tool に適合させたときの C2A Core の PR へのリンク
例: