comment nommer vos projets
- nom_projet-7.25-1.0-alpha
- nom_projet-7.25-1.0-beta1
- nom_projet-7.25-1.0-dev2
- nom_projet-7.25-1.0-rc3
- nom_projet-7.25-1.0-stable4
- nom_projet-7.25-1.0-unstable5
suivre les meilleures pratiques?
12
Voir Drupal.org pour les conventions de dénomination des versions et plus d'explications .
Résumé:
rc = Release Candidate, jugé approprié par l'auteur pour les sites de production.
rc : une version candidate ne doit être créée que lorsque tous les problèmes de type de bogue critiques sont signalés corrigés dans la file d'attente des problèmes du projet. Cette balise ne doit être utilisée que lorsque le développeur estime que le projet est prêt à être utilisé sur un site de production. Il n'y a pas de meilleure pratique officielle pour la durée pendant laquelle un projet doit être candidat à la publication avant de créer une version officielle .0, mais il est suggéré qu'il soit sorti pendant au moins un mois avec un statut défini sur "nécessite une révision". Si quelque chose (par exemple, un nouveau bogue critique est signalé) rend nécessaire la création d'une nouvelle version au cours de cette période, une nouvelle version candidate doit être créée et celle-ci doit rester pendant au moins un mois avec le statut défini sur "nécessite une révision".
Il est acceptable de marquer un module "rc" avec des problèmes de demandes de fonctionnalités en suspens. Les auteurs de module ne sont pas tenus de répondre à toutes les demandes de fonctionnalités que les utilisateurs du module publient dans la file d'attente des problèmes.
Voici une description des autres balises de version autorisées:
instable : le projet n'est pas dans un état stable. Il existe probablement de nombreux bogues non corrigés, y compris des problèmes de sécurité. L'API peut changer sans préavis. Le schéma de la base de données peut changer sans hook_update_Nêtre mis en œuvre. L'utilisation et l'API peuvent ne pas être documentées. L'installation d'une nouvelle version instable implique la désinstallation du projet, perdant ainsi toutes les données. Uniquement pour ceux qui souhaitent avoir un aperçu précoce du projet. Pas encore adapté au développement partagé.
alpha : la plupart des erreurs signalées sont résolues, mais il peut encore y avoir de graves problèmes connus en suspens, y compris des problèmes de sécurité. Le projet n'est pas complètement testé, il peut donc y avoir de nombreux bugs inconnus. Il existe un fichier README.txt / README.md qui documente le projet et son API (le cas échéant). L'API et le schéma de base de données peuvent être instables, mais toutes les modifications apportées à ceux-ci sont signalées dans les notes de publication et hook_update_Nsont mises en œuvre pour préserver les données via les modifications de schéma, mais aucun autre chemin de mise à niveau / mise à jour. Ne convient pas aux sites de production. Le public cible est les développeurs qui souhaitent participer aux tests, au débogage et au développement du projet.
bêta : toutes les pertes de données critiques et les bogues de sécurité sont résolus. Si le module propose une API, elle doit être considérée comme figée, afin que ceux qui utilisent l'API puissent commencer à mettre à niveau leurs projets. S'il s'agit d'une mise à niveau ou d'une mise à jour d'un projet, un chemin de mise à niveau / mise à jour doit être proposé et les utilisateurs existants doivent pouvoir mettre à niveau / mettre à jour vers la nouvelle version sans perte de données. Toute la documentation doit être à jour. Le public cible est les développeurs qui souhaitent participer aux tests, au débogage et au développement du projet, et les développeurs d'autres projets qui interfacent le projet. Ne convient généralement pas aux sites de production, mais peut être utilisé sur certains sites de production si l'administrateur du site connaît bien le projet et sait gérer les problèmes restants.
Les chaînes "dev" et "stable" ne sont pas valides dans le cadre d'une balise de version, mais les versions de développement non balisées sont supposées être "dev" et reçoivent des descriptions telles que "7.x-1.x-dev" par Drupal Système de mise à jour des versions .org pour indiquer qu'il s'agit de versions de développement non balisées.
Toutes les balises de version doivent se terminer par un nombre. Les chiffres ne servent qu'à distinguer les versions de la même classe. Le premier est numéroté "1" (comme dans "alpha1"), le suivant "2", et ainsi de suite.
PS. Les chaînes indiquant les versions (telles que "7.x-1.0-alpha4") sont connues sous le nom de "balises de version" dans le langage git, pas de "noms". Et vous n'utilisez jamais la version mineure drupal dans le cadre d'une balise, vous utilisez plutôt "x".