Commencer à contribuer à Blockly

Blockly est Open Source et est principalement géré par une petite équipe. Nous acceptons les contributions des développeurs extérieurs à l'équipe principale. Sans notre communauté, nous ne pourrions pas créer toutes les fonctionnalités demandées ni corriger tous les bugs signalés. Cette section contient des guides généraux qui peuvent vous être utiles, en particulier si vous débutez dans le développement Open Source.

Pour obtenir des informations spécifiques à Blockly que vous devez lire avant de contribuer, consultez les sections Contribuer au cœur et Contribuer aux exemples.

Quel dépôt ?

Un dépôt contient tous les fichiers d'un même projet. Blockly comporte deux dépôts : blockly core et blockly-samples.

Blockly core est le dépôt de la bibliothèque Blockly. Utilisez ce dépôt si vous souhaitez modifier le comportement principal de Blockly de manière à ce qu'il s'applique à tous les utilisateurs de la bibliothèque.

Exemples Blockly est le dépôt d'exemples, de plug-ins et d'ateliers de programmation. Utilisez ce dépôt si vous souhaitez créer ou modifier un plug-in, écrire un atelier de programmation, ou créer ou modifier un exemple.

Guide détaillé

Voici les étapes générales à suivre chaque fois que vous apportez une modification.

  1. Installez Git et Node en suivant les liens de la section Outils.
  2. Dupliquez et clonez le dépôt. GitHub propose un excellent tutoriel sur la duplication d'un dépôt. Pour l'appliquer à Blockly, il vous suffit de remplacer chaque instance de octocat/Spoon-Knife par RaspberryPiFoundation/blockly ou RaspberryPiFoundation/blockly-samples, selon le dépôt dans lequel vous souhaitez travailler.
  3. Synchronisez votre fork. GitHub propose également un tutoriel pour synchroniser un fork.
  4. Consultez la branche principale. Dans Blockly Core, il s'agit de la branche develop. Dans blockly-samples, il s'agit de la branche master.
  5. Installez les dépendances et les outils de compilation en exécutant npm install dans le répertoire racine.
  6. Créez une branche en exécutant git checkout -b myBranchName dans un terminal. Le nom doit vous aider à vous souvenir de ce sur quoi vous travaillez.
  7. Apportez les modifications souhaitées.
  8. Validez vos modifications en suivant le guide pour core ou samples.
  9. Enregistrez vos modifications avec git commit -am "fix: My commit message". En savoir plus sur les messages de commit
  10. Transférez vos modifications vers GitHub avec git push origin myBranchName.
  11. Ouvrez une demande d'extraction lorsque votre code est prêt. Un membre de l'équipe Blockly examinera vos modifications et les fusionnera dans Blockly si elles sont approuvées. Pour en savoir plus, consultez Processus d'examen des demandes d'extraction.