新しいパッケージをリリースするには、 package.xml にリリースノートを書く必要があります。 リリースノートには、直近のリリースと比べて何が変わったのかを明確に記述しなければなりません。 また、たとえばベータ版から安定版に移行したなど 安定性 が変化したときは、同じ安定度のひとつ前のリリースからの変更点も記述しなければなりません。
新機能の概要や、修正されたバグの一覧などを記載することになるでしょう。 単にバグ番号だけを書くのではなく、バグの表題も書いておくことが大切です。 単に番号で示されるよりも、言葉で説明されたほうがそのバグについて思い出しやすいからです。 PEAR のウェブインターフェイスでは、自動的に "bug #<number>" をリンクにします。 複数名でパッチを修正した場合は、ユーザのハンドルをメッセージに追加することもできます。
例 24-2よくないリリースノートの例
|
例 24-3よいリリースノートの例
|