日本語 PEAR マニュアル

PEAR マニュアル
前のページ		次のページ

第 11 章公式投稿採択プロセス

目次
Step 1: 要求事項
Step 2: 議論の開始
Step 3: PEPr の使用
投稿内容の変更

PEAR の初期においては、新しいパッケージの投稿は、PEAR 開発者メーリングリストにメールを出すという略式なものでした。時が経つにつれ、新たなパッケージの投稿の数も劇的に増加し、すべての投稿を把握することが難しくなって来ました。

そこで、問題を解決するために、WEB ベースの投稿管理システムが構築されました。そのシステムは、PEPr と呼ばれています。 "PEAR Proposal system" の略称で、スパイス（の胡椒）と同じように発音されます。

この章では、まず、PEPr を用いて投稿を行う際の要求事項とワークフローについて述べます。ついで、実際に投稿する方法についての情報を提供します。最後に、投稿が採択された後に行うべき事柄について説明します。

この章を読めば、すぐにパッケージを投稿することができることでしょう。

Step 1: 要求事項

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

パッケージの名称を決める
各パッケージは、当然、それぞれ異なる名前である必要があります。適切なパッケージ名はどうのようなものか"感じる"ために、既存パッケージ一覧を参照してください。
パッケージ名の選択は、ある種の反復プロセスで、投稿採択プロセス中に名前を変更することになるかも知れません。
パッケージの所属カテゴリを決める
パッケージの名称がそれぞれ異なるということに関連していますが、パッケージはカテゴリに所属する必要があります。カテゴリは、パッケージブラウザにリストされています。
パッケージの説明を書く
投稿するには、パッケージの説明が必要です。この説明には、パッケージについて細部まで細かく記述する必要は無いですが、少なくとも、基本的なコンセプトと機能の一覧については記しておくべきです。パッケージが受け入れられたら、1行にまとめた概要と、全文の説明を書くこととなります。
パッケージのライセンスを選択する
各パッケージは、認定済みのオープンソースライセンスの基で利用許諾される必要があります。オープンソースライセンスについて良く知らないのならば、 PHP ライセンスを選ぶと良いでしょう。 PEAR グループは、この件に関連して、ライセンスについてのアナウンスメント (License Announcement) を発表しています。
サンプルと文書を書く
サンプルや文書なしでは、PEAR 開発者がパッケージを評価することができませんし、ユーザがパッケージを利用することもできません。