Developer FAQ: Difference between revisions

m
no edit summary
mNo edit summary
Line 1: Line 1:
[[Category:FAQ EN]]
[[Category:FAQ EN]]
{{ToTranslate}}
{{TemplateDocDev}}
{{TemplateDocDev}}


Line 85: Line 84:
For this, see page [[Translator documentation]]
For this, see page [[Translator documentation]]


= Changer mon système de numérotation des factures en cours de route =
= Change my numbering system after start =
{{ToTranslate}}
Si le nouveau système de numérotation n'entre pas en conflit avec l'ancien, il suffit d'aller dans le menu Configuration - Modules - Configuration factures et prendre un nouveau modèle dans la liste.
Si le nouveau système de numérotation n'entre pas en conflit avec l'ancien, il suffit d'aller dans le menu Configuration - Modules - Configuration factures et prendre un nouveau modèle dans la liste.
Si le nouveau système rentre en conflit, il est nécessaire de renuméroter vos références existantes. Cela peut-être fait avec une requête SQL.
Si le nouveau système rentre en conflit, il est nécessaire de renuméroter vos références existantes. Cela peut-être fait avec une requête SQL.
Line 101: Line 101:




= Soumettre un patch, amélioration ou participer au développement =
= Submit a patch, work and help on development =
 
{{ToTranslate}}
* '''Avec accès CVS en écriture '''
* '''Avec accès CVS en écriture '''
A ce jour, les accès en écriture au CVS sont restreints (le nombre de commit étant déjà suffisamment dynamique). Si vous bénéficiez à l'heure actuelle d'un accès CVS en écriture, utilisez-le et à condition que ce qui est commité corresponde bien à votre grade de développeur Dolibarr (Voir [[FAQ_D%C3%A9veloppeur#Comment_devenir_d.C3.A9veloppeur_officiel|FAQ Développeur - Devenir développeur officiel]] pour les différents grades).
A ce jour, les accès en écriture au CVS sont restreints (le nombre de commit étant déjà suffisamment dynamique). Si vous bénéficiez à l'heure actuelle d'un accès CVS en écriture, utilisez-le et à condition que ce qui est commité corresponde bien à votre grade de développeur Dolibarr (Voir [[FAQ_D%C3%A9veloppeur#Comment_devenir_d.C3.A9veloppeur_officiel|FAQ Développeur - Devenir développeur officiel]] pour les différents grades).
Line 148: Line 148:
See page [[Developpement_module]]
See page [[Developpement_module]]


= Comment devenir développeur officiel =
= How to be an official developer =


Dans la galaxie du projet Dolibarr, il existe plusieurs intervenants de différents niveaux/grades.
In the galaxy of the project Dolibarr, there are several stakeholders at different levels / 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.
The number of developers is important and contributions and changes, for any project that wants to reach a certain level of quality, must be controlled and validated (both for functional needs and for 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.
For this reason, the write access on the source (CVS) is limited and governed by an organization that is described in the following.
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.
Each developer has a ''grade'' depending on seniority and the past. The level of authorization of a person on the project increases with the stages of promotion in 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.
The course of a Dolibarr developer passes through these steps, which are classified by a title familiar to fans of science fiction. Here are the steps.
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.
It is important to understand that this organization has the sole purpose of improving the quality of Dolibarr and it is necessary that it is rigorously used. So do not be offended if, as a developer, you can not have a CVS write access for some time.


Les grades des contributeurs au projet Dolibarr sont les suivants:
The ranks of contributors to the project Dolibarr are:




== * Soldat ==
== * Soldier ==


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.
The first thing that a person willing to help is to be familiar with the rules and standards developments.
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...
Reading the [[Developer Documentation]], you have shown sufficient willingness to become automatically ''Soldier'' (grade level ''Soldier''). And just read is not the easiest ...


Ce grade s'obtient sans validation supérieure. C'est un grade de principe, de départ.
This grade is obtained without validation higher. It is a grade of principle, to start.


== * Chasseur ==
== * Hunter ==


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).  
The next step is to submit your first patch, starting with simple, on the dev Mailing List (see [[Developer FAQ]] for the procedure) or on the forum (Preferred Mailing List).


A votre première soumission acceptée (incluse dans le CVS par un Amiral ou Jedi), vous entrez alors automatiquement dans la famille des '''Chasseurs''' de l'alliance Dolibarr.
At your first bid accepted (included in CVS by an Admiral, Jedi or Yoda), you automatically enter into the family of ''Fighters' of the Dolibarr alliance.


Le nombre de chasseurs n'est pas limité. Plus, il y en aura, plus on sera fort.
The number of hunters is not limited. The more we are, the more we will be strong.
Les chasseurs représentent la force vive principale de l'alliance Dolibarr.
The hunters are the main force of the alliance Dolibarr.


== * Z-6PO ==
== * Z-6PO ==


Si vous parlez couramment une langue non ou mal traduite dans Dolibarr, un '''Jedi''' ou '''Yoda''' vous offrira un accès CVS pour vous permettre de faire des commits sur le CVS du projet à condition qu'il soit limité à des objectifs de traductions.
If you are fluent in a language not or poorly translated into Dolibarr, a ''Jedi'' or ''Yoda'' will give you CVS access so you can make commits to the CVS of the project. But commits must be limited to changes for translations purposes.
Ce grade peut donc s'obtenir assez vite.
This grade can be obtained quickly enough. Just ask it on mailing list.


== * Amiral de l'alliance ==
== * Admiral ==


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.
Only after a variable time (which can be very long) to the rank of a Chasseur, and many patches of suitable quality had been sent, a Yoda in place allow you to make CVS commits extended for cause of any translation patch.
Vous êtes devenu un '''Amiral''' de l'alliance Dolibarr.
You have become a'' '''Admiral' of the 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'''.
This title did not ask, it is obtained by a decision or proposal of a'' 'Jedi''' or'' '''Yoda' who believes that you have submitted enough patch to be a serious'' 'Admiral '' '.
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''').
Access CVS a'' '''Admiral', however, must be used to commit or translations, or bug fixes reported on Savannah or forum (such as corrections and personal issues a patch submitted by a'' 'Hunter''').
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'''.
Like CVS must necessarily include in the description (the commit log field), the issue of Savannah bug corrected or the title of the forum message indicating the problem. Only a translation escapes this constraint (no restrictions for translations). Failure to observe this constraint may lead to demotion to the rank of'' '''Hunter.
Pour la soumission de nouvelles fonctionnalités, il faut donc obligatoirement continuer sur le principe de patchs envoyés sur la ML.
For submission of new features, it must necessarily proceed on the principle of patches sent to the 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
Obtaining the rank of Admiral is rare as limited. Dolibarr quality can not be achieved by a number of Amiraux controlled, but that does not have a number of
développeurs (Chasseurs) très important (grâce au système de patch).
Developers (Hunters) very important (through the patch).


== * Jedi ==
== * Jedi ==


C'est encore au bout d'un temps variable (surement le plus long de tous) au rang d'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é.
This is even after a variable time (probably the longest of all) to the rank of Admiral, and the quality of the patch that was sent is satisfactory, that Yoda will tell you that you are authorized to perform commits the features without restrictions, provided, however, to have the endorsement of the principle of a Master Yoda who you will explain the feature.
Il peut toutefois y avoir une restriction temporaire définie par un Yoda pour raison de release proche.
There may be a temporary restriction defined by a Yoda release due to close.
Vous êtes alors devenu un '''Jedi'''.
You will then become a'' '''Jedi.


Ce titre ne se demande pas, il s'obtient par proposition d'un autre Jedi ou d'un Yoda.
This title did not ask, it is obtained by another proposal or a Jedi Yoda.


Ce privilège est toutefois exceptionnel. La qualité de Dolibarr ne pouvant être atteinte
This privilege is exceptional. Dolibarr quality can not be achieved
que par un nombre de Jedi contrôlé, ce qui n'empêche pas d'avoir un nombre de
by a controlled number of Jedi, but that does not have a number of
développeurs (Chasseurs) très important (grâce au système de patch).
Developers (Hunters) very important (through the patch).


== * Yoda ==
== * Yoda ==


Au nombre de 1 à 5, être un '''Yoda''', c'est assurer la gestion globale du développement du projet. Ce rang s'obtient par succession, suite au départ d'un Yoda qui se retire, par nomination directe ou vote organisé par le Yoda partant.
The number of 1 to 5, be a'' 'Yoda''' is the overall management of project development. This ranking is obtained by inheritance, following the departure of a Yoda who withdraws, or by direct appointment by the vote held Yoda partant.
 
== * Et Dark Vador ? ==


Il existe hélas. Les membres de l'empire sont les 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 constructives qui aident à progresser. Certains sont très très fort en mauvaise foie ou mauvais ton. Ce sont des Dark Vador.
== * And Darth Vader? ==
Heureusement, statistiquement, on ne constate l'apparition et la mort que d'un seul Dark Vador par an environ...


There are unfortunately. Members of the empire are the parasites that pollute the forum or mailing-list messages or constructive criticism, which slows the development of Dolibarr rather than offering constructive criticism to help improve. Some are very very strong bad liver and bad tone. These are Darth Vader.
Fortunately, statistically, there does not appear and the death of one Dark Vador per year ...


= Current team =
= Current team =
See page [[Dolibarr Project]] to know list of current people that work on Dolibarr, with their current grade.
See page [[Dolibarr Project]] to know list of current people that work on Dolibarr, with their current grade.