diaporama
Transcription
diaporama
MOODLE À L’UNIVERSITÉ DE MONTRÉAL NOTRE INSTANCE DE MOODLE : STUDIUM 2 733 COURS OUVERTS PAR SESSION 40 944 ÉTUDIANTS 2 341 ENSEIGNANTS INTRODUCTION ○ https://www.openhub.net/p/moodle 34 contributeurs dans les 30 derniers jours 174 contributeurs dans les 12 derniers mois INTRODUCTION Moodle Registered websites 69 375 Courses 9 365 019 Users 82 750 099 Source : https://moodle.org/stats/ (2016-03-14) PLAN DE LA PRÉSENTATION ○ Pourquoi contribuer à la communauté ? ○ Le rythme de livraison de la communauté ○ Les versions supportées ○ Partager un correctif ou une amélioration ○ Comment proposer une correction sur une chaîne de langue ○ Enrichir la documentation en ligne ○ Contribuer au Moodle Users Association ○ Contacts au Moodle HQ POURQUOI CONTRIBUER À LA COMMUNAUTÉ ○ Nos développements peuvent servir à d’autres institutions ○ Contribuer à faire évoluer Moodle ○ Nos développements peuvent être inclus dans le code officiel ● ○ Réduction du coût de maintenance Être informés sur la dynamique de la communauté (roadmap, priorités…) LE RYTHME DE LIVRAISON DE LA COMMUNAUTÉ ○ 2 mises à jour majeures par an ○ 6 mises à jour mineures par an ○ http://docs.moodle.org/dev/Releases LE RYTHME DE LIVRAISON DE LA COMMUNAUTÉ LES VERSIONS SUPPORTÉES LTS (Long term support) ● ● ● 1 an pour les corrections de bogues 3 ans pour les bogues de securité ○ au lieu de 18 mois Prochaine LTS : 3.1 2.7 2.8 ○ ○ 2.9 master 3.0 Bug fixes for general core bugs in 2.8.x will end 9 November 2015 (12 months). Bug fixes for security issues in 2.8.x will end 9 May 2016 (18 months). PARTAGER UN CORRECTIF OU UNE AMÉLIORATION ○ Les informations importantes d’un ticket sur le Moodle Tracker ○ Le cycle de vie d’un ticket sur le Moodle Tracker ○ Le kit de développement Moodle (MDK) ○ Comment utiliser Git efficacement ○ Travail requis pour qu’une amélioration soit acceptée ○ Amélioration vs bogue ○ Comment présenter une solution pour qu’elle soit acceptée LES INFORMATIONS IMPORTANTES D’UN TICKET SUR LE MOODLE TRACKER Priorité Statut Versions affectées Versions corrigées Instructions de tests Git Votes et observateurs LE CYCLE DE VIE D’UN TICKET SUR LE MOODLE TRACKER ○ http://docs.moodle.org/dev/Process ○ http://docs.moodle.org/dev/Guidelines_for_contributed_code LE KIT DE DÉVELOPPEMENT MOODLE (MDK) ○ Une collection de commandes pour faciliter la vie des développeurs ● Réduire le nombre de commandes ● Requiert Python ○ Quelques fonctionnalités ● Créer une instance Moodle ● Mettre à jour Moodle ● ... https://docs.moodle.org/dev/Moodle_Development_kit COMMENT UTILISER GIT EFFICACEMENT ○ Créer une organisation GitHub ● Ajouter des développeurs COMMENT UTILISER GIT EFFICACEMENT ○ Git Clone : ● git clone [email protected]:StudiUM/moodle.git moodlegit ○ Pour se connecter à la communauté Git : ● cd moodlegit ● git remote add upstream https://github.com/moodle/moodle.git ● git fetch upstream ○ Rebase : ● git checkout -b MOODLE_XX_STABLE origin/MOODLE_XX_STABLE ● git fetch upstream ● git rebase upstream/MOODLE_XX_STABLE COMMENT UTILISER GIT EFFICACEMENT Pour partager un correctif ou une amélioration : ○ Créer des branches pour chaque version supportée ○ Les documenter dans le Moodle Tracker TRAVAIL REQUIS POUR QU’UNE AMÉLIORATION SOIT ACCEPTÉE ○ Tests unitaires ● http://phpunit.de/ ● Test Driven Development ● http://fr.wikipedia.org/wiki/Test_Driven_Development ○ Tests automatisés ● http://behat.org/ ● http://docs.seleniumhq.org/ ● http://docs.moodle.org/dev/Behat_integration ● http://docs.moodle.org/dev/Acceptance_testing TRAVAIL REQUIS POUR QU’UNE AMÉLIORATION SOIT ACCEPTÉE ○ Style de code ● http://docs.moodle.org/dev/Coding_style class some_custom_class { function class_method() { $myvariable = 'foo' echo $myvariable; } } TRAVAIL REQUIS POUR QU’UNE AMÉLIORATION SOIT ACCEPTÉE ○ CiBoT ● Code Sniffer ○ http://docs.moodle.org/dev/CodeSniffer ○ Code Checker – Plugin Moodle ● https://moodle.org/plugins/view.php?plugin=local_codechecker ○ Moodle PHPdoc check ● https://moodle.org/plugins/view.php?plugin=local_moodlecheck TRAVAIL REQUIS POUR QU’UNE AMÉLIORATION SOIT ACCEPTÉE ○ Git commit message ● MDL-xxxx CODE LOCATION: Court résumé (72 caractères maximum) ○ Obtenir un lien de comparaison pour les branches AMÉLIORATION VS BOGUE ○ Changements appliqués sur la branche master ● Amélioration ● Tache impliquant un changement dans la BD ○ Changements appliqués aux versions précédentes ● Corrections de bogues COMMENT PRÉSENTER UNE SOLUTION POUR QU’ELLE SOIT ACCEPTÉE ○ Statu quo ● Conserver le comportement par défaut ● Créer une configuration ○ Proposer le changement le plus générique possible ○ Respecter le style de code ○ Inclure des instructions de tests ○ Avoir un répertoire surGitHub ● Les patches ne sont pas acceptés ○ Sauf pour les correctifs de sécurité ○ Bonne documentation sur le Tracker ○ Nombre de votes COMMENT PROPOSER UNE CORRECTION SUR UNE CHAÎNE DE LANGUE ○ Utiliser AMOS ● http://lang.moodle.org/ ○ Gestionnaires des paquetages de langue ● Vérifient la cohérence d’un terme ● Acceptent ou refusent les demandes de traduction ● Proposent des alternatives si nécessaire ○ Pour obtenir la dernière version ● Mettre à jour les paquetages de langue ENRICHIR LA DOCUMENTATION EN LIGNE ○ Moodle.org propose une documentation multi-lingue au format wiki ○ Il suffit de se créer un compte sur Moodle.org pour pouvoir modifier et enrichir cette documentation ○ La documentation en anglais est très complète et mise à jour régulièrement ○ La documentation en français n'est pas mise à jour aussi rapidement ● Vos contributions peuvent améliorer la situation https://docs.moodle.org/2x/fr/Contribution_à_la_documentation ENRICHIR LA DOCUMENTATION EN LIGNE CONTRIBUER AU MOODLE USERS ASSOCIATION ○ https://moodleassociation.org/ CONTRIBUER AU MOODLE USERS ASSOCIATION CONTACTS AU MOODLE HQ ○ Martin Dougiamas ● Founder of Moodle and principal developer ○ Damyon Wiese ● Development Manager ○ Michael de Raadt ● Research Director ○ Marina Glancy ● Development Process Manager ○ Collette McCann ● Marketing and Outreach Officer ○ Frédéric Massart ● Analyst/developer (francophone) ○ http://moodle.com/hq/ CONCLUSION ○ Quand c’est libre et ouvert, tout le monde devrait s’impliquer ○ Travail d’équipe ○ Les contributions permettent de donner plus de cohérence et de qualité à Moodle QUESTIONS MERCI !