Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

keep a changelog形式のchangelogを手書きする #704

Open
3 tasks done
Tracked by #545
qryxip opened this issue Dec 3, 2023 · 1 comment
Open
3 tasks done
Tracked by #545

keep a changelog形式のchangelogを手書きする #704

qryxip opened this issue Dec 3, 2023 · 1 comment

Comments

@qryxip
Copy link
Member

qryxip commented Dec 3, 2023

内容

0.14 → 0.15の変更について、keep a changelog形式のchangelogを手書きします。

0.14を使っていたユーザーが0.15に移るとき、知りたいのはどこが変わったかということだと思います。それを手書きのchangelogに書きます。

生成されたWhat's Changedでは不十分だと考えます。例えば0.15.0-preview.16のですが、このようなPR一覧を見てAPIの変更について知るのは困難だと思います。0.15での主な変更点としてはstruct/class Synthesizerと、VVMと、async APIだと思うのですが、それがどこで実装されたかというと#370で、数百個あるPRからそこに辿り着いた上で把握するのは無理かと。

PRの一覧で済ませるOSSも多いですが、それでも例えばRust Analyzer(きっちり7日に一度リリース)のchangelogのように、"New features"と"Fixes"と"Internal Improvements"に分けた上でスクショを添えるといった工夫だけでも加えるところもあります。

Pros 良くなる点

ユーザーが変更箇所をすみやかに把握できるようになる

Cons 悪くなる点

手間

実現方法

書く。

リポジトリの/CHANGELOD.mdに置いておいて、リリース時に転記というのがよいと思います。

VOICEVOXのバージョン

0.15

OSの種類/ディストリ/バージョン

  • Windows
  • macOS
  • Linux

その他

Pydanticのやつのようなマイグレーションガイドも用意できるとよさそう。

@Hiroshiba
Copy link
Member

あった方が良いだろうなと思いました!
もう現状の段階のチェンジログを書いてしまってもいいかも?

優先度ですが、must/should/want/canのうちshouldとwantの間くらいかなと思っています。(温度感違ったら教えてください!)
そもそもそれぞれの優先度感を策定していませんが、直感的には・・・これのためにリリースタイミングを先送りにすることはないが、スケジュール的に大丈夫なのであれば書き足す、って感じでしょうか。

あ。CI回しておかないと表記ミスりそうな気がしました。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants