Gestion:Développement/Orientation

De Wikimedica
Posez vos questions sur Aide:Développement/Forum

Sur cette page vous trouverez les différentes étapes à accomplir en tant que nouveau développeur sur le projet Wikimedica pour bien comprendre la plateforme et ses processus de développement.

D'emblée, il importe de mentionner que Wikimedica calque sa manière de faire sur MediaWiki, tant au niveau standards de codage, de collaboration qu'au niveau architectural. La raison est d'une part le fait que MediaWiki soit le logiciel sur lequel fonctionne Wikimedica, mais également de manière à faciliter le transfert de technologies entre ces deux projets.

Environnement

L'environnement logiciel de Wikimedica est composé de:

En support se trouvent plusieurs autres services faisant l'usage d'autres technologies comme Python, Java et NodeJS. Pour plus d'informations, voir Wikimedica:Infrastructure.

Étapes

Se familiariser avec le projet et créer ses comptes

  1. Demandez à un administrateur de vous créer un compte.
  2. Débutez en lisant Wikimedica:Bienvenue, la page est dédiée aux utilisateurs professionnels de la santé, mais elle énonce les principes du projet.
  3. Créez vos comptes de développeurs secondaires:
    1. sur GitHub; une fois fait, avertissez Utilisateur:Antoine Mercier-Linteau,
    2. sur MediaWiki (si vous possédez déjà un compte sur Wikipédia, c'est le même).
  4. Parcourez l'aide de Wikimedica afin d'en comprendre le fonctionnement du point de vue des utilisateurs et des éditeurs (dont vous faites partie, car vous serez appelés à modifier le wiki)
Vous possédez un compte sur Wikimedica, donc vous faites partie de la communauté des éditeurs, que vous soyez professionnels de la santé ou non.
Si vous trouvez une erreur, corrigez-la! Si vous pensez à une amélioration, faites-la ou proposez la!

Commencer à développer

On rentre dans le vif du sujet... Il y a énormément de documentation sur MediaWiki. Certains voudront la lire, d'autres préféreront se lancer et apprendre avec les tutoriels, exemples et code source. À vous de choisir. Sinon, il y a largement de travail à faire du côté des modèles, de l'interface, des widgets, etc. Toutes ces tâches se font à même le wiki en wikicode ou en JavaScript.

Pour ceux qui sont intéressés à faire du développement sur la source:

  1. Lire le guide des développeurs.
  2. Déployer MediaWiki en local (cette étape deviendra beaucoup plus facile avec un outil comme Meza):
    1. installer MediaWiki avec Git
    2. déployer MediaWiki (sur Apache préférablement);
    3. récupérer LocalSettings.php, un dump des fichiers statiques de Wikimedica et un dump de la DB (demander à Utilisateur:Antoine Mercier-Linteau);
    4. installer les extensions utilisées par Wikimedica;
    5. si voulu, déployer les services satellitaires tel que Parsoid, le créateur de livre et RestBase.
  3. Il est quasi indispensable de se configurer un environnement de développement avec un debugger, mais c'est théoriquement optionnel.

Ensuite, vous n'avez plus qu'à vous choisir une tâche!