Начните вносить свой вклад в Blockly

Blockly — это проект с открытым исходным кодом, который в основном поддерживается небольшой командой. Мы приветствуем вклад разработчиков, не входящих в основную команду; без участия сообщества мы не смогли бы реализовать все запрошенные функции или исправить все обнаруженные ошибки. Этот раздел содержит общие руководства, которые могут быть вам полезны, особенно если вы новичок в разработке ПО с открытым исходным кодом.

Информацию, относящуюся к Blockly, с которой следует ознакомиться перед внесением вклада, см. в разделах « Вклад в Core» и «Вклад в Samples» .

Какой репозиторий?

Репозиторий содержит все файлы одного проекта. У Blockly есть два репозитория: blockly core и blockly-samples.

Ядро Blockly — это репозиторий библиотеки Blockly. Используйте этот репозиторий, если вы хотите изменить поведение ядра Blockly таким образом, чтобы оно распространялось на всех пользователей библиотеки.

Blockly samples — это репозиторий примеров, плагинов и практических работ. Используйте этот репозиторий, если хотите создать или изменить плагин, написать практические работы или создать или изменить пример.

Шаг за шагом

Это общие шаги, которым вам следует следовать каждый раз при внесении изменений.

  1. Установите Git и Node, перейдя по ссылкам в разделе «Инструменты» .
  2. Создайте форк и клонируйте репозиторий. На GitHub есть отличное руководство по созданию форка репозитория . Чтобы применить его к Blockly, просто замените все вхождения octocat/Spoon-Knife на RaspberryPiFoundation/blockly или RaspberryPiFoundation/blockly-samples , в зависимости от того, с каким репозиторием вы хотите работать.
  3. Синхронизируйте свой форк. GitHub также предоставляет руководство по синхронизации форка .
  4. Посмотрите на основную ветку. В blockly core это ветка develop . В blockly-samples это ветка master .
  5. Установите зависимости и инструменты сборки, запустив npm install в корневом каталоге.
  6. Создайте новую ветку , выполнив git checkout -b myBranchName в терминале. Имя поможет вам запомнить, над чем вы работаете.
  7. Внесите изменения.
  8. Проверьте свои изменения, следуя руководству для сердечников или образцов .
  9. Сохраните изменения с помощью git commit -am "fix: My commit message" . Подробнее о сообщениях коммита читайте здесь .
  10. Отправьте изменения на GitHub с помощью git push origin myBranchName .
  11. Когда ваш код будет готов, откройте запрос на извлечение . Член команды Blockly проверит ваши изменения и объединит их в Blockly, если они будут одобрены. Подробнее см. в разделе «Процесс проверки PR» .