Doc-dev/fr

Dernière modification de cette page le 14 avril 2008 à 10:54.

Un article de Milimail.

Sommaire

1 Convention de Gestion des Numéros de Version
- 1.1 Cycle de vie d'un produit informatique
- 1.2 Mode de numérotation retenue
2 Extensions
3 Gestion des tags et des branches
4 Organisation du gestionnaire de sources
5 Autre documentation technique

Convention de Gestion des Numéros de Version

Ce chapitre décrit les bonnes pratiques pour gérer les versions du client de messagerie universel Milimail et les extensions développées pour ce client.
La version d'un logiciel correspond à un état donné de son évolution. Elle est souvent associée à une numérotation qui permet de l'identifier, voire dans certains cas à un nom symbolique. Les noms symboliques ne sont pas utilisés sur ce projet.

Cycle de vie d'un produit informatique





Phase alpha : disponible pour avoir un aperçu de l'avancement du produit, tester les fonctions déjà implémentées.
Phase beta : le set de fonctionnalités est généralement figé, version de test destinée à trouver un maximum de bugs.
Release candidate : version candidate à être la version finale.
Version ou version GA (pour General Availability) : version finale du produit. Une mise à jour peut également être une nouvelle version du produit.

Mode de numérotation retenue

Le numéro de version se présentera de la manière suivante :

major.minor.revision.build

Note: le numéro associé à la révision, peut-être aussi appelé maintenance.
Voici comment incrémenter les différentes valeurs du numéro de version.



Valeurs	Raison d’incrémentation	Quand
major	Ajout d’une fonctionnalité importante. Changement significatif du comportement de l’application. Changement significatif de l’apparence de l’application.	Dès que les développements commencent.
minor	Ajout de fonctionnalités non critique vis-à-vis du cœur de l’application. Evolution de fonctionnalités existantes sans affecter l’existant.	Dès que les développements commencent.
revision	A chaque livraison de correction d’anomalies (Même si y’a 1 seule correction).	Dépend de la livraison de la version finale : AVANT : 0 plus un tag indiquant dans quel cycle de vie on se trouve (*). APRES : chaque fois que des corrections sont livrées.
build	Livraison interne ou externe d’une distribution du produit.	Chaque fois que la distribution est publiée. Que ce soit pour le service intégration, qualité ou le client final.

(*) Cycle de vie : alpha, beta ou rc (release candidate).

Extensions

Les chapitres suivants présentent pour chaque extension, un rappel des fonctionnalités et leur architecture technique.

Gestion des tags et des branches

    Tag THUNDERBIRD_2_0_0_0_RELEASE
         |
         |
--TRUNK--------------------------------------------------------------------------------->
            \             \                    
             \             \                   
              \             \                                                     
               \             \                                                   
                \             \--MILIMAIL_V0_BRANCH----------------*Merge------Fixes---->
                 \                                                /              
                  \                                              /              
                   \--DSN_BRANCH--------------------------------/----------------------->
                    \                                          /              
                     \                                        /             
                      \--MDN_EXTENDED_BRANCH-----------------/-------------------------->
                       \                                    /              
                        \                                  /             
                         \--SIGNED_RECEIPT_BRANCH---------/----------------------------->
                          \                              /              
                           \                            /             
                            \--TRIPLE_WRAPPING_BRANCH--/-------------------------------->
                             \                        /              
                              \                      /             
                               \--XSMTP_BRANCH------/----------------------------------->
                                \
                                 \
                                  \--PRIORITY_BRANCH------------------------------------>

Organisation du gestionnaire de sources

+ milimail                                // Root
   |
   + branches                             // Branches
   |  + mozilla
   |     + DSN_BRANCH
   |     + SIGNED_RECEIPT_BRANCH
   |     + TRIPLE_WRAPPING_BRANCH
   |
   + Docs                                 // Documentations
   |
   + Source
   |  + Dev
   |  + Stable                            // Extensions released
   |     + mdn_extended
   |     + send_format_ldap
   |
   + tags                                  // Tags
   |  + mdn_extended                       // Tags for extension MDN_EXTENDED
   |     + MDN_EXTENDED_0_1_RELEASE
   |  + mozilla                            // Tags for Thunderbird, matching sources from Mozilla.org
   |     + THUNDERBIRD_2_0_0_0_RELEASE
   |  + send_format_ldap                   // Tags for extension SEND_FORMAT_LDAP
   |     + SEND_FORMAT_LDAP_0_1_RELEASE
   |  + triple_wrapping                    // Tags for functionnality TRIPLE_WRAPPING
   |     + TRIPLE_WRAPPING_0_1_RELEASE
   |
   + trunk                                  // Trunk
      + dsn
      + mdn_extended
      + mozilla
      + send_format_ldap
      + LanguagePackages
         + fr