Utiliser League
comme espace de nom pour la norme PSR-4. Le code source est entièrement contenu dans le dossier src
.
Adhérer à la norme PSR-2 comme style d’écriture de code.
Être reprise sur Packagist avec league
comme espace de nom vendeur.
Contenir des tests unitaires. Le but étant d’avoir une bibliothèque testée à plus de 80% pour la version 1.0.
Documenter tous les élements du code source avec des DocBlock.
Utiliser la gestion sémantique de version pour gérer les mises à jour.
Maintenir un fichier CHANGELOG.
Utiliser Travis-CI pour continuellement vérifier les normes d’écriture et lancer ses tests unitaires.
Contenir un fichier README complet.
Exclure les fichiers optionnels à l’aide d’un un fichier .gitattributes.
Au lieu de publier nos bibliothèques via nos comptes personnels nous le faisons ici pour plusieurs raisons dont la plus importante est :
Un problème partagé est un problème à moitié résolu.
Ensemble, nous travaillons plus efficacement, nous obtenons des remarques, répondons aux demandes et aux pull requests plus rapidement.
Nous n’avons pas l’intention de réinventer la roue sauf si elle est vieille, mal entretenue ou inutilisable. Si le code ne peut pas être installé via Composer, possède une API écrite en utilisant BizZaroCapS, ne contient aucun test unitaire, est buggé et que son chef de projet l’a abandonné, alors ce problème peut très probablement être résolu avec un nouveau départ, et nous nous chargerons de le rendre aussi excellent que possible.