Step 1: 要求事項

投稿する 前 に行っておく必要のある事項は、以下の通りです。

• パッケージの名称を決める

  各パッケージは、当然、それぞれ異なる名前である必要があります。 適切なパッケージ名はどうのようなものか"感じる"ために、 既存パッケージ一覧を 参照してください。

  パッケージ名の選択は、ある種の反復プロセスで、 投稿採択プロセス中に名前を変更することになるかも知れません。

• パッケージの所属カテゴリを決める

  パッケージの名称がそれぞれ異なるということに関連していますが、 パッケージはカテゴリに所属する必要があります。 カテゴリは、パッケージブラウザに リストされています。

• パッケージの説明を書く

  投稿するには、パッケージの説明が必要です。 この説明には、パッケージについて細部まで細かく記述する必要は無いですが、 少なくとも、基本的なコンセプトと機能の一覧については記しておくべきです。 パッケージが受け入れられたら、1行にまとめた概要と、全文の説明を 書くこととなります。

• パッケージのライセンスを選択する

  各パッケージは、認定済みのオープンソースライセンスの基で利用許諾される 必要があります。オープンソースライセンスについて良く知らないのならば、 新 BSD ライセンスを選ぶと良いでしょう。 PEAR グループは、この件に関連して、 ライセンスについてのアナウンスメント (License Announcement) を発表しています。

• サンプルと文書を書く

  サンプルや文書なしでは、PEAR 開発者がパッケージを評価することができませんし、 ユーザがパッケージを利用することもできません。

• 依存性を示す

  他の PEAR パッケージや特定の OS や外部アプリケーションなど、 パッケージの実行に必要な外部要素を列挙し、依存性のリストを作成します。

  依存性リストの例

  パッケージは、Linux でのみ動作し、DB パッケージ、および バージョン 1.8.4 以降の Log パッケージを必要とし、 PHP 4.3.0 以降でのみ動く場合、依存性リストは以下のようになります。

  Linux
  DB
  Log >= 1.8.4
  PHP >= 4.3.0