{{tag>groupe}}
----

====== Groupe des développeurs des applications web ======

Ubuntu-fr vous propose en permanence le meilleur d'Ubuntu grâce à son forum, sa documentation et son planet. Tous cela fonctionne grâce à des applications web. L'équipe des développeurs ubuntu-fr-webteam est en charge du développement et du maintiens de ces applications.

===== Nos applications =====

Actuellement nous utilisons :
  * Drupal sur www.ubuntu-fr.org
  * Dokuwiki sur doc.ubuntu-fr.org
  * FluxBB sur forum.ubuntu-fr.org
  * Dotclear sur planet.ubuntu-fr.org
  * Suivi (application interne) sur suivi.ubuntu-fr.org
  * ...

===== Nos outils de travail =====

Le code source, les rapports de bugs, et l'organisation des groupes en charge de ces outils, tout cela se passe sur la plateforme de développement de Canonical, Launchpad.net.

Pour participer sur [[:Launchpad]], il faudra vous créer un compte utilisateur.

Vous trouverez l'ensemble de ces applications web dans le projet : [[https://launchpad.net/ubuntu-fr|ubuntu-fr]]

Si vous souhaitez nous contactez, vous pouvez utiliser la liste de diffusion [[http://listes.ubuntu-fr.org/info/ubuntu_webdev-fr|ubuntu_webdev-fr]] ou le salon IRC [[irc://irc.freenode.net/ubuntu-fr|#ubuntu-fr-devweb]].

===== Comment nous aider =====
==== Signaler un bug ====
Si vous constatez une erreur dans nos outils, quelque chose qui s'affiche mal, un problème de sécurité, ou quoi que ce soit, n'hésitez pas à nous le signaler : [[https://bugs.launchpad.net/ubuntu-fr/+filebug|rapporter un bug]]

Choisissez le projet concerné. Il vous sera demandé un rapide résumé du problème, afin de vérifier si ce problème n'a pas déjà été signalé, et ensuite une description plus complète. Mettez le maximum de détails, une capture d'écran, la façon de le reproduire le problème, le navigateur et sa version si vous la connaissez, la version d'Ubuntu éventuellement

Une fois toutes ces informations renseignées, nous recevrons un mail et ne manqueront pas d'apporter une réponse à ce problème rapidement.

==== Aider à améliorer le code ====
Pour commencer il faudra apprendre les commandes de base de [[:git|git]], qui est le gestionnaire de version que nous utilisons, et être un peu familiarisé avec [[https://launchpad.net/|Launchpad]].

Après cela, suivez simplement les étapes suivantes :

=== Étape 1 : récupérer le code source ===

Allez sur l'onglet //code// et sélectionnez le code que vous voulez récupérer. Vous verrez alors affiché une ligne de commande sous "Get this branch".

Ouvrez un [[:terminal]], créez un dossier de travail si besoin et rendez-vous dans votre dossier de travail et entrez cette commande, comme par exemple pour la documentation :
<code>
mkdir documentation
cd documentation
git clone https://git.launchpad.net/ubuntu-fr-doc 
</code>

Un nouveau dossier sera créé (dans l'exemple le dossier est //ubuntu-fr-doc//) contenant le code source dans votre dossier de travail (dans l'exemple //documentation//). Entrez dans ce dossier et vous pouvez commencer à faire vos modifications.

=== Étape 2 : Faire vos modifications ===

Vous êtes sur une copie locale du code source, vous pouvez en faire ce que vous voulez, l'adapter, la modifier, l'améliorer, c'est votre branche de travail, vous pouvez faire ce que voulez sans impacter le travail des autres.

Une seule recommandation, nous ne vérifions qu'une amélioration à la fois, c'est à dire que si vous voulez corriger des bugs, n'en corrigez pas plusieurs sur la même branche alors qu'il est si simple de créer une nouvelle branche.

Par exemple pour travailler sur le **bug 12345**, créer une nouvelle branche dans votre dossier de travail :
<code>git checkout -b fixe-12345</code>
La commandes auront pour effet de créer la branche **fixe-12345** dans laquelel vous allez travailler.

=== Étape 3 : Versionner localement ces modifications ===

Vous travaillez sur du code localement, avec un gestionnaire de version, n'hésitez pas à enregistrer vos modifications par étapes afin de pouvoir revenir en arrière si besoin. La commande est tout simplement sous git:
<code>
git add monfichier.php
git commit -m "un message explicatif"
</code>

Si vos modifications corrigent un bug, précisez le dans le commit, cela permettra d'automatiser certaines actions dans le rapport de bug (exemple avec le bug 12345) :
<code>git commit -m "12345: message explicatif"</code>

=== Étape 4 : Envoyer ces modification sur Launchpad ===

Une fois que vous êtes satisfait des modifications apportées à votre branche de travail, il ne vous reste plus qu'à la partager afin que nous puissions contrôler le code et l'intégrer à la branche principale. Là encore c'est très simple, vous aller envoyer votre branche dans votre espace personnel. Par exemple pour une modification corrigeant le **bug 12345** du projet **ubuntu-fr-doc** :
<code>git push origin fixe-12345</code>

Vous pouvez aussi juste vouloir partager votre travail pour le montrer à une autre personne pour qu'elle vous aide, ou qu'elle récupère vos modifications.

=== Étape 5 : Nous proposer ces modifications ===

Vous avez réalisé toutes les étapes ci-dessus, il ne vous reste plus qu'à nous demander d'intégrer votre code dans la branche principale. Pour cela rendez-vous sur launchpad, sur la page où ce trouve ce code. Dans notre exemple :
<code>https://code.launchpad.net/~votresurnom/ubuntu-fr-doc/fixe-12345</code>

Vous aurez sur cette page un lien << Propose for merging >>, il ne vous restera plus qu'à compléter si besoin les renseignements demandés. Un ou plusieurs membres de l'équipe ubuntu-fr-webteam vérifieront ces modifications et les intégrerons à la branche principale ou vous demanderont avant quelques modifications.

=== Astuces ===

Pour vous familiariser avec le couple bazaar / Launchpad, il existe une [[https://staging.launchpad.net/ubuntu-fr|version démo de Launchpad]] où vous pouvez vous entraîner sans conséquences.\\
Pour en savoir un peu plus sur git il y a une page qui le traite un peu plus dans le détail [[:git|git]]