OnlyTranslate の製品アップデートを始める理由
OnlyTranslate はこれまでも GitHub Releases で変更を記録してきました。しかし、リリースノートで説明できるのは主に「何が変わったか」であり、「なぜ変えたのか」まで十分に伝えるのは難しいものです。製品アップデートはその間を補い、開発と実際の利用をより分かりやすくつなぎます。
ここでお伝えすること
製品アップデートでは、主に次の三つを扱います。
- 機能紹介：本文を優先するウェブ翻訳、動画の対訳字幕、ローカル EPUB などの使い方と、どのような問題を解決するための機能かを説明します。
- 開発ノート：体験の背景にある判断、実装、トレードオフを、まだ解決できていない点も含めて共有します。
- 主要リリース：使い方が大きく変わるリリースについて、変更一覧より詳しい背景や移行方法を案内します。
すべてのコミットを掲載することも、決まった頻度を守るためだけに更新することもありません。理解していただく価値のある変化があったときに記録します。
リリースノートとの違い
GitHub Releases は、引き続きパッケージ、変更一覧、リリース履歴の確認場所です。製品アップデートでは、機能が生まれた理由、現在できること、うまく動作しない可能性がある場面など、利用体験を中心に説明します。
記事と拡張機能の実際の動作が異なる場合は、現在の拡張機能、使い方、公開ソースコードを優先してください。記事も速やかに修正します。
フィードバックを次の開発へ
各アップデートには二つの窓口を用意します。ウェブサイトから非公開で送信するか、GitHub で公開して話し合うことができます。フィードバックを継続して管理・対応できる場所へ集約するため、サイト内の公開コメントは現在提供していません。
これらの記事を一方向のお知らせで終わらせず、OnlyTranslate が解決しようとしていることを理解しやすくし、実際の読書場面を次の開発へ持ち帰るための場所にしていきます。