31,003
edits
FAQ Développeur: Difference between revisions
Jump to navigation
Jump to search
no edit summary
No edit summary |
|||
| Line 7: | Line 7: | ||
Dans la galaxie du projet Dolibarr, il existe plusieurs intervenants de différents niveaux/grades. | 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. | 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 | Pour cette raison, les accès en écriture sur les sources (serveur GIT) 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. | 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. | 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 | 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 GIT en écriture avant un certain délai. | ||
Les grades des contributeurs au projet Dolibarr sont les suivants: | Les grades des contributeurs au projet Dolibarr sont les suivants: | ||
| Line 34: | Line 34: | ||
Les taches sembles pour commencer sont les taches qui possède la propriété "Task opened to external developers" à "oui". Si la valeur est "non", oubliez la, cela signifie qu'elle sera traité par un développeur de grade Jedi. | Les taches sembles pour commencer sont les taches qui possède la propriété "Task opened to external developers" à "oui". Si la valeur est "non", oubliez la, cela signifie qu'elle sera traité par un développeur de grade Jedi. | ||
A votre première soumission acceptée (incluse dans le | A votre première soumission acceptée (incluse dans le GIT 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. | Le nombre de chasseurs n'est pas limité. Plus, il y en aura, plus on sera fort. | ||
| Line 43: | Line 43: | ||
<span id="Z-6PO">'''* Z-6PO'''</span> | <span id="Z-6PO">'''* Z-6PO'''</span> | ||
Si vous parlez couramment une langue non ou mal traduite dans Dolibarr, un '''Jedi''' ou '''Yoda''' peut attribuer, à votre login Savannah, les droits d'écriture directement dans les sources | Si vous parlez couramment une langue non ou mal traduite dans Dolibarr, un '''Jedi''' ou '''Yoda''' peut attribuer, à votre login Savannah, les droits d'écriture directement dans les sources GIT du projet. | ||
Aller sur le site http://savannah.nongnu.org pour créer un compte et réclamer l'inclusion au projet en tant que Z-6PO pour votre langue. | Aller sur le site http://savannah.nongnu.org pour créer un compte et réclamer l'inclusion au projet en tant que Z-6PO pour votre langue. | ||
Voir aussi la page [[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 utiliser le serveur | Voir aussi la page [[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 utiliser le serveur GIT qui contient les sources dont les fichiers langues à mettre à jour. Ce droit d'écriture dans les sources 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]] | La liste des acteurs Dolibarr avec ce grade est disponible sur la page [[:Category:Z-6PO]] | ||
| Line 53: | Line 53: | ||
<span id="Amiral">'''* Amiral'''</span> | <span id="Amiral">'''* Amiral'''</span> | ||
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 | 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 GIT pour un motif étendu à tout correctif de bug (en plus de la traduction). | ||
Vous êtes devenu un '''Amiral''' de l'alliance Dolibarr. | 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'''. | 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 | L'accès GIT 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 | Tout commit GIT doit ainsi obligatoirement inclure, dans la description (le champ log de commit), le numéro du bug Savannah (BUG Tracker http://savannah.nongnu.org/bugs/?group=dolibarr) OU le titre du message du forum signalant le problème. Seul les traductions échappent à 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. | Pour la soumission de nouvelles fonctionnalités, il faut donc obligatoirement continuer sur le principe de patchs envoyés sur la ML. | ||
| Line 136: | Line 136: | ||
Si vous cherchez comment commencer ou contribuer aux développements Dolibarr, lisez le chapitre [[FAQ_Développeur#Comment devenir développeur officiel]]. Si votre patch est déjà prêt et voulez le diffuser, ce chapitre est pour vous. | Si vous cherchez comment commencer ou contribuer aux développements Dolibarr, lisez le chapitre [[FAQ_Développeur#Comment devenir développeur officiel]]. Si votre patch est déjà prêt et voulez le diffuser, ce chapitre est pour vous. | ||
== Avec accès | == Avec accès GIT en écriture == | ||
A ce jour, les accès en écriture au | A ce jour, les accès en écriture au GIT sont restreints (le nombre de commit étant déjà suffisamment dynamique). Si vous bénéficiez à l'heure actuelle d'un accès GIT 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). | ||
Si, vous n'avez pas accès au | Si, vous n'avez pas accès au GIT (vous êtes donc au grade de [[FAQ Développeur#Soldat|Soldat]] ou [[FAQ Développeur#Chasseur|Chasseur]] de l'alliance Dolibarr), il est nécessaire de suivre la procédure qui suit... | ||
== Sans accès | == Sans accès GIT en écriture == | ||
Sans accès | Sans accès GIT en écriture (sans compte développeur savannah), il est nécessaire de générer et fournir par mail, sur la mailing-list développeur '''dolibarr-dev''' votre fichier patch (Voir ici pour cela https://savannah.nongnu.org/mail/?group=dolibarr). Voici la procédure pour générer un fichier patch: | ||
''Sous tout OS:'' [[Image:Logo_windows.png|20px]] [[Image:Logo_ubuntu.png|20px]] [[Image:Logo_apple.png|20px]] | ''Sous tout OS:'' [[Image:Logo_windows.png|20px]] [[Image:Logo_ubuntu.png|20px]] [[Image:Logo_apple.png|20px]] | ||
| Line 147: | Line 147: | ||
Voici la ''méthode Pro'' selon laquelle travailler pour pouvoir générer un tel fichier patch: | Voici la ''méthode Pro'' selon laquelle travailler pour pouvoir générer un tel fichier patch: | ||
- Avoir un répertoire qui contient la version de Dolibarr de référence (résultat de la mise à jour | - Avoir un répertoire qui contient la version de Dolibarr de référence (résultat de la mise à jour GIT ou bien tout simplement l'arborescence résultant de la décompression d'un snapshot tgz de Dolibarr). On appellera ce répertoire '''ancien_rep'''. Vous pouvez récupérer le snapshot de la version de dev en cours sur le [http://www.dolibarr.org/downloads/ site officiel de Dolibarr - espace téléchargement - version développement]. | ||
- Avoir un autre répertoire qui contient l'arborescence de Dolibarr mais dans laquelle vous faites ou avez fait vos modifications. On appellera ce répertoire '''nouveau_rep'''. | - Avoir un autre répertoire qui contient l'arborescence de Dolibarr mais dans laquelle vous faites ou avez fait vos modifications. On appellera ce répertoire '''nouveau_rep'''. | ||
| Line 166: | Line 166: | ||
Éventuellement recommencer pour chaque fichier modifié. | Éventuellement recommencer pour chaque fichier modifié. | ||
Au final, on obtient un beau fichier ''resultat.patch'' qui contient toutes les modifications au bon format. | Au final, on obtient un beau fichier ''resultat.patch'' qui contient toutes les modifications au bon format. | ||
''Tester/Appliquer un patch'' | ''Tester/Appliquer un patch'' | ||