Dans les premiers temps de PEAR, tous les nouveaux
paquets étaient proposés par un email informel à la liste
des développeurs PEAR.
Mais avec le temps, le nombre de nouvelles
propositions grandissant tout à fait considérablement,
il est devenu très difficile de gérer manuellement
toutes les propositions.
Un système de gestion des propositions par le web a été
mis en place pour résoudre ces problèmes.
Ce système a été baptisé PEPr.
Il se prononce comme le "poivre" en anglais et s'entend
comme << PEAR
Proposal system >>.
Ce chapitre décrit la manière de faire une proposition via PEPr.
Après cela, nous vous expliquerons comment réaliser votre
premier proposition.
Et finalement, nous vous apprendrons
ce que vous devrez faire après avoir terminé votre proposition.
Après avoir lu de ce chapitre, vous devriez être capable de
commencer une proposition pour votre code.
L'énumération qui suit liste les éléments
les plus importants qui doivent être fait et rendu disponibles
avant d'entamer une nouvelle proposition.
Trouver un nom pour le paquet
Il est évident que chaque paquet doit avoir un nom unique.
Pour vous faire une << idée >> des formats des noms,
vous devriez regarder la liste
des paquets existants.
Choisir un nom pour un paquet est un processus itératif
et il est probable que vous allez changer de nom avant la dernière
étape du processus de la proposition.
Trouver une catégorie pour le paquet
Les paquets similaires ont un nom unique, ils sont organisés par
catégories, listées sur cette page.
écrire une description du paquet
Pour démarrer votre proposition, vous devez écrire une
description du paquet.
Cette description ne doit pas faire
mention de tous les détails du paquet, mais doit être une
mise en évidence des concepts de base
et de ses fonctionnalités.
Quand votre paquet aura été accepté,
vous devrez fournir un résumé ainsi qu'un
texte complet descriptif.
Choisir une licence pour votre paquet
Chaque paquet doit avoir une licence OpenSource acceptable.
Si vous ne savez pas quelle licence choisir, vous devriez opter
pour la license PHP.
Le groupe PEAR a créé une
annonce
sur les licenses, qui fournit des détails sur ce sujet.
Écrire des exemples et la documentation
Sans exemples propres d'utilisation et sans
documentation, les développeurs PEAR ne pourront pas
évaluer votre paquet
et les utilisateurs ne pourront pas l'utiliser.
Liste des dépendances
Faire une liste des dépendances signifie que vous devez lister
toutes les entrées externes comme les autres paquets PEAR,
certains systèmes ou applications externes qui sont
nécessaire au bon fonctionnement de votre paquet.
