Vize
ノートレーン
リファレンス ドキュメントは、「これをどのように使用するか?」という質問に答えるのに優れています。彼らは次のような質問に答えるのがはるかに下手です。
- なぜこの機能が追加されたのですか?
- このアーキテクチャはどのようなトレードオフによって導かれたのでしょうか?
- 有望だがまだ安定していない実験はどれですか?
- プロジェクトは次に何を学ぼうとしていますか?
そのため、ドキュメントには別のメモレーンが含まれるようになりました。
ここに属するもの
メモは意図的に不規則です。投稿には次のようなものがあります。
- 1週間のコンパイラ作業後の開発ブログ
- 新しいクレートのアーキテクチャに関する記述
- Musea、LSP、または Vite 統合に関する設計メモ
- 便利ですが、バージョン タグに関連付けられていない短いプロジェクトの更新
すべてをリリースノートに記載しない理由
リリース ノートは出荷時の変更に合わせて最適化されています。それらは明確で実行可能なものである必要があります。
メモには、機能の背後にあるコンテキスト、ロードマップの形状、読者が長期的にプロジェクトを理解するのに役立つ考え方など、より広範なストーリーテリングのための余地が生まれます。
書き込み方向
疑問がある場合:
- 投稿で出荷されたものを発表する場合はリリース ノートを使用してください
- 投稿で思考、進捗状況、実験について説明している場合はメモを使用してください