Line 1:
Line 1:
[[Category:FAQ FR]]
[[Category:FAQ FR]]
{{TemplateDocDev}}
{{TemplateDocDev}}
+
+
+
= Comment devenir développeur officiel =
+
+
Dans la galaxie du projet Dolibarr, il existe plusieurs intervenants de différents niveaux/grades.
+
Le nombre de développeurs et contributions est important, hors tout projet qui veut atteindre un certains niveau de qualité se doit d'avoir une gestion contrôlée et des modifications validées des évolutions, aussi bien au niveau des besoins fonctionnels que du code.
+
Pour cette raison, les accès en écriture sur les sources (serveur CVS) sont limités et régies par une organisation qui est décrite dans les lignes qui suivent.
+
Chaque développeur a un '''grade''' qui dépend de son ancienneté et de ces contributions passées. Le niveau d'habilitations d'une personne sur le projet augmente avec les étapes de promotion de grade.
+
+
Le cursus d'un développeur Dolibarr passe donc par ces étapes, que l'on classe par un titre familié aux adeptes de sciences fictions. Voici ces étapes.
+
Il est important de comprendre que cette organisation a pour seul but d'améliorer la qualité de Dolibarr et qu'il est nécessaire qu'elle soit rigoureusement respectée afin d'attendre ce but. Ne soyez donc pas offensé si, en tant que développeur, vous ne pouvez disposer d'un accès CVS en écriture avant un certain délai.
+
+
Les grades des contributeurs au projet Dolibarr sont les suivants:
+
+
+
== * Soldat ==
+
+
La première chose qu'une personne désireuse d'aider doit faire et d'abord se familiariser avec les règles et normes de développements.
+
En lisant toute la [[Documentation Développeur]], vous faites preuve de volonté suffisante pour devenir automatiquement '''Soldat''' (Votre grade est au niveau '''Soldat'''). Et tout lire, c'est pas le plus facile...
+
+
Ce grade s'obtient sans validation supérieure. C'est un grade de principe, de départ.
+
+
Compte tenu du grade, il n'est pas possible d'établir une liste de tous les acteurs du projet Dolibarr ayant ce grade (liste en perpétuelle évolution).
+
+
== * Chasseur ==
+
+
L'étape suivante consiste à soumettre des patch, en commençant par des simples, soit sur la Mailing List dev (voir [[FAQ_D%C3%A9veloppeur#Soumettre_un_patch.2C_am.C3.A9lioration_ou_participer_au_d.C3.A9veloppement|FAQ Développeur]] pour la procédure), soit sur le forum (Mailing List préférée).
+
+
A votre première soumission acceptée (incluse dans le CVS par un Amiral, Jedi ou Yoda), vous entrez alors automatiquement dans la famille des '''Chasseurs''' de l'alliance Dolibarr.
+
+
Le nombre de chasseurs n'est pas limité. Plus, il y en aura, plus on sera fort.
+
Les chasseurs représentent la force vive principale de l'alliance Dolibarr.
+
+
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Chasseur]]
+
+
== * Z-6PO ==
+
+
Si vous parlez couramment une langue non ou mal traduite dans Dolibarr, un '''Jedi''' ou '''Yoda''' peut attribuer, à votre compte Savannah, les droits d'écriture directement dans les sources CVS du projet (Voir [[FAQ_D%C3%A9veloppeur#R.C3.A9cup.C3.A9rer.2Fmettre_.C3.A0_jour_la_version_CVS_de_d.C3.A9veloppement|Récupérer/mettre à jour la version CVS de développement]] pour savoir comment les utiliser). Ce droit ne doit toutefois être utiliser qu'à condition qu'il soit limité à des objectifs de traductions.
+
Ce grade peut donc s'obtenir assez vite.
+
+
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Z-6PO]]
+
+
== * Amiral ==
+
+
Ce n'est qu'au bout d'un temps variable (qui peut être très long) au rang de Chasseur, et si de nombreux patch de qualité satisfaisante ont été envoyée, qu'un Yoda en place vous autorisera à réaliser des commits CVS pour un motif étendu de la traduction à tout correctif.
+
Vous êtes devenu un '''Amiral''' de l'alliance Dolibarr.
+
+
Ce titre ne se demande pas, il s'obtient par décision ou proposition d'un '''Jedi''' ou '''Yoda''' qui estime que vous avez soumis suffisamment de patch pour être un sérieux '''Amiral'''.
+
L'accès CVS d'un '''Amiral''' doit cependant n'être utilisé que pour commiter soit des traductions, soit des corrections de bugs déclarées sur Savannah ou le forum (que ces corrections soient personnelles ou issues d'un patch soumis par un '''Chasseur''').
+
Tout commit CVS doit ainsi obligatoirement inclure, dans la description (le champ log de commit), le numéro du bug Savannah corrigé OU le titre du message du forum signalant le problème. Seul une traduction échappe à cette contrainte (pas de restrictions pour les traductions). Le non respect de cette contrainte, peut provoquer une rétrogradation au rang de '''Chasseur'''.
+
Pour la soumission de nouvelles fonctionnalités, il faut donc obligatoirement continuer sur le principe de patchs envoyés sur la ML.
+
+
L'obtention du grade d'Amiral est toutefois rare car limité. La qualité de Dolibarr ne pouvant être atteinte que par un nombre d'Amiraux contrôlé, ce qui n'empêche pas d'avoir un nombre de
+
développeurs (Chasseurs) très important (grâce au système de patch).
+
+
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Admiral]]
+
+
== * Jedi ==
+
+
C'est au bout d'un temps variable (surement le plus long de tous) au rang de contributeur Amiral, et si la qualité des patch qui ont été envoyée est satisfaisante, qu'un Yoda vous signalera que vous êtes autorisé à réaliser des commits sans restrictions de fonctionnalités, à condition d'avoir cependant l'aval de principe d'un Maitre Yoda à qui vous aurez expliquer la fonctionnalité.
+
Il peut toutefois y avoir une restriction temporaire définie par un Yoda pour raison de release proche.
+
Vous êtes alors devenu un '''Jedi'''.
+
+
Ce titre ne se demande pas, il s'obtient par proposition d'un autre Jedi ou d'un Yoda.
+
+
Ce privilège est toutefois exceptionnel. La qualité de Dolibarr ne pouvant être atteinte
+
que par un nombre de Jedi contrôlé, ce qui n'empêche pas d'avoir un nombre de
+
développeurs (Chasseurs) très important (grâce au système de patch).
+
+
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Jedi]]
+
+
== * Yoda ==
+
+
Au nombre de 1 à 5, être un '''Yoda''', c'est assurer la gestion globale du développement du projet. Ce rang s'obtient successivement au départ d'un Yoda qui se retire, ou par décision des autres Yoda de se renforcer, par nomination directe ou vote organisé par le Yoda partant.
+
+
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Yoda]]
+
+
== * Et Dark Vador ? ==
+
+
Il existe hélas. Il y aura toujours des parasites qui polluent le forum ou la mailing-list de messages ou critiques non constructives, qui ralentissent le développement de Dolibarr plutôt que d'offrir des critiques aidant à progresser. Certains sont très très fort en mauvaise foie ou mauvais ton. Ce sont eux que l'on appellent les Dark Vador.
+
Heureusement, statistiquement, on ne constate l'apparition et la mort que d'un à deux Dark Vador par an environ...
+
+
= L'équipe actuelle =
+
Voir la page [[projet Dolibarr]] pour connaitre la liste des personnes, participant au projet Dolibarr, à chaque grade actuellement.
+
+
= Démarrer le développement =
+
Consulter '''intégralement''' la [[Documentation Développeur]] pour assimiler toutes les règles et principes imposées aux développeurs.
+
Vous pouvez aussi consulter les FAQ suivantes.
= Récupérer/mettre à jour la version CVS de développement =
= Récupérer/mettre à jour la version CVS de développement =
Line 82:
Line 170:
Cette procédure de migration/mise à jour est conçue pour fonctionner quel que soit l'état de départ et peut être repassée plusieurs fois sans risque.
Cette procédure de migration/mise à jour est conçue pour fonctionner quel que soit l'état de départ et peut être repassée plusieurs fois sans risque.
−
−
= Démarrer le développement =
−
−
Consulter '''intégralement''' la [[Documentation Développeur]] pour assimiler toutes les règles et principes imposées aux développeurs.
−
Vous pouvez aussi consulter les FAQ suivantes.
= Comment créer un nouveau theme =
= Comment créer un nouveau theme =
Line 164:
Line 247:
= Comment packager/livrer un module =
= Comment packager/livrer un module =
Voir la page [[Développement_module#Cr.C3.A9er_un_package_pour_livrer_et_installer_votre_module|Developpement module - Créer un package pour livrer et installer votre module]]
Voir la page [[Développement_module#Cr.C3.A9er_un_package_pour_livrer_et_installer_votre_module|Developpement module - Créer un package pour livrer et installer votre module]]
−
−
= Comment devenir développeur officiel =
−
−
Dans la galaxie du projet Dolibarr, il existe plusieurs intervenants de différents niveaux/grades.
−
Le nombre de développeurs et contributions est important, hors tout projet qui veut atteindre un certains niveau de qualité se doit d'avoir une gestion contrôlée et des modifications validées des évolutions, aussi bien au niveau des besoins fonctionnels que du code.
−
Pour cette raison, les accès en écriture sur les sources (serveur CVS) sont limités et régies par une organisation qui est décrite dans les lignes qui suivent.
−
Chaque développeur a un '''grade''' qui dépend de son ancienneté et de ces contributions passées. Le niveau d'habilitations d'une personne sur le projet augmente avec les étapes de promotion de grade.
−
−
Le cursus d'un développeur Dolibarr passe donc par ces étapes, que l'on classe par un titre familié aux adeptes de sciences fictions. Voici ces étapes.
−
Il est important de comprendre que cette organisation a pour seul but d'améliorer la qualité de Dolibarr et qu'il est nécessaire qu'elle soit rigoureusement respectée afin d'attendre ce but. Ne soyez donc pas offensé si, en tant que développeur, vous ne pouvez disposer d'un accès CVS en écriture avant un certain délai.
−
−
Les grades des contributeurs au projet Dolibarr sont les suivants:
−
−
−
== * Soldat ==
−
−
La première chose qu'une personne désireuse d'aider doit faire et d'abord se familiariser avec les règles et normes de développements.
−
En lisant toute la [[Documentation Développeur]], vous faites preuve de volonté suffisante pour devenir automatiquement '''Soldat''' (Votre grade est au niveau '''Soldat'''). Et tout lire, c'est pas le plus facile...
−
−
Ce grade s'obtient sans validation supérieure. C'est un grade de principe, de départ.
−
−
Compte tenu du grade, il n'est pas possible d'établir une liste de tous les acteurs du projet Dolibarr ayant ce grade (liste en perpétuelle évolution).
−
−
== * Chasseur ==
−
−
L'étape suivante consiste à soumettre des patch, en commençant par des simples, soit sur la Mailing List dev (voir [[FAQ_D%C3%A9veloppeur#Soumettre_un_patch.2C_am.C3.A9lioration_ou_participer_au_d.C3.A9veloppement|FAQ Développeur]] pour la procédure), soit sur le forum (Mailing List préférée).
−
−
A votre première soumission acceptée (incluse dans le CVS par un Amiral, Jedi ou Yoda), vous entrez alors automatiquement dans la famille des '''Chasseurs''' de l'alliance Dolibarr.
−
−
Le nombre de chasseurs n'est pas limité. Plus, il y en aura, plus on sera fort.
−
Les chasseurs représentent la force vive principale de l'alliance Dolibarr.
−
−
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Chasseur]]
−
−
== * Z-6PO ==
−
−
Si vous parlez couramment une langue non ou mal traduite dans Dolibarr, un '''Jedi''' ou '''Yoda''' peut attribuer, à votre compte Savannah, les droits d'écriture directement dans les sources CVS du projet (Voir [[FAQ_D%C3%A9veloppeur#R.C3.A9cup.C3.A9rer.2Fmettre_.C3.A0_jour_la_version_CVS_de_d.C3.A9veloppement|Récupérer/mettre à jour la version CVS de développement]] pour savoir comment les utiliser). Ce droit ne doit toutefois être utiliser qu'à condition qu'il soit limité à des objectifs de traductions.
−
Ce grade peut donc s'obtenir assez vite.
−
−
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Z-6PO]]
−
−
== * Amiral ==
−
−
Ce n'est qu'au bout d'un temps variable (qui peut être très long) au rang de Chasseur, et si de nombreux patch de qualité satisfaisante ont été envoyée, qu'un Yoda en place vous autorisera à réaliser des commits CVS pour un motif étendu de la traduction à tout correctif.
−
Vous êtes devenu un '''Amiral''' de l'alliance Dolibarr.
−
−
Ce titre ne se demande pas, il s'obtient par décision ou proposition d'un '''Jedi''' ou '''Yoda''' qui estime que vous avez soumis suffisamment de patch pour être un sérieux '''Amiral'''.
−
L'accès CVS d'un '''Amiral''' doit cependant n'être utilisé que pour commiter soit des traductions, soit des corrections de bugs déclarées sur Savannah ou le forum (que ces corrections soient personnelles ou issues d'un patch soumis par un '''Chasseur''').
−
Tout commit CVS doit ainsi obligatoirement inclure, dans la description (le champ log de commit), le numéro du bug Savannah corrigé OU le titre du message du forum signalant le problème. Seul une traduction échappe à cette contrainte (pas de restrictions pour les traductions). Le non respect de cette contrainte, peut provoquer une rétrogradation au rang de '''Chasseur'''.
−
Pour la soumission de nouvelles fonctionnalités, il faut donc obligatoirement continuer sur le principe de patchs envoyés sur la ML.
−
−
L'obtention du grade d'Amiral est toutefois rare car limité. La qualité de Dolibarr ne pouvant être atteinte que par un nombre d'Amiraux contrôlé, ce qui n'empêche pas d'avoir un nombre de
−
développeurs (Chasseurs) très important (grâce au système de patch).
−
−
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Admiral]]
−
−
== * Jedi ==
−
−
C'est au bout d'un temps variable (surement le plus long de tous) au rang de contributeur Amiral, et si la qualité des patch qui ont été envoyée est satisfaisante, qu'un Yoda vous signalera que vous êtes autorisé à réaliser des commits sans restrictions de fonctionnalités, à condition d'avoir cependant l'aval de principe d'un Maitre Yoda à qui vous aurez expliquer la fonctionnalité.
−
Il peut toutefois y avoir une restriction temporaire définie par un Yoda pour raison de release proche.
−
Vous êtes alors devenu un '''Jedi'''.
−
−
Ce titre ne se demande pas, il s'obtient par proposition d'un autre Jedi ou d'un Yoda.
−
−
Ce privilège est toutefois exceptionnel. La qualité de Dolibarr ne pouvant être atteinte
−
que par un nombre de Jedi contrôlé, ce qui n'empêche pas d'avoir un nombre de
−
développeurs (Chasseurs) très important (grâce au système de patch).
−
−
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Jedi]]
−
−
== * Yoda ==
−
−
Au nombre de 1 à 5, être un '''Yoda''', c'est assurer la gestion globale du développement du projet. Ce rang s'obtient successivement au départ d'un Yoda qui se retire, ou par décision des autres Yoda de se renforcer, par nomination directe ou vote organisé par le Yoda partant.
−
−
La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Yoda]]
−
−
== * Et Dark Vador ? ==
−
−
Il existe hélas. Il y aura toujours des parasites qui polluent le forum ou la mailing-list de messages ou critiques non constructives, qui ralentissent le développement de Dolibarr plutôt que d'offrir des critiques aidant à progresser. Certains sont très très fort en mauvaise foie ou mauvais ton. Ce sont eux que l'on appellent les Dark Vador.
−
Heureusement, statistiquement, on ne constate l'apparition et la mort que d'un à deux Dark Vador par an environ...
−
−
= L'équipe actuelle =
−
Voir la page [[projet Dolibarr]] pour connaitre la liste des personnes, participant au projet Dolibarr, à chaque grade actuellement.
= Comment être informé de ce qui se passe sur Dolibarr ? =
= Comment être informé de ce qui se passe sur Dolibarr ? =
Voir la page [[FAQ Comment être informé de l'actualité de Dolibarr ?]]
Voir la page [[FAQ Comment être informé de l'actualité de Dolibarr ?]]