Manuel Pear
Chapitre 15. Le processus formel de proposition
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.
étape 1: éléments nécessaires pour une proposition
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 New BSD License. Le groupe PEAR a créé une annonce sur les licences, 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.
Remonter 
