Blockly'ye katkıda bulunmaya başlama

Blockly açık kaynaklıdır ve öncelikle küçük bir ekip tarafından yönetilir. Çekirdek ekibin dışındaki geliştiricilerin katkılarını memnuniyetle karşılıyoruz. Topluluğumuz olmadan istenen her özelliği oluşturmamız veya bildirilen her hatayı düzeltmemiz mümkün değildir. Bu bölümde, özellikle açık kaynak geliştirme konusunda yeniyseniz size yardımcı olabilecek genel rehberler yer alır.

Katkıda bulunmadan önce okumanız gereken Blockly'ye özgü bilgiler için Çekirdeğe Katkıda Bulunma ve Örneklere Katkıda Bulunma bölümlerine bakın.

Hangi depo?

Depo, tek bir projeye ait tüm dosyaları içerir. Blockly'nin iki deposu vardır: blockly core ve blockly-samples.

Blockly core, Blockly kitaplığının deposudur. Kitaplığın tüm kullanıcıları için geçerli olacak şekilde Blockly'nin temel davranışında değişiklik yapmak istiyorsanız bu depoyu kullanın.

Blockly örnekleri, örnekler, eklentiler ve codelab'ler için depodur. Eklenti oluşturmak veya değiştirmek, bir codelab yazmak ya da örnek oluşturmak veya değiştirmek istiyorsanız bu depoyu kullanın.

Adım adım

Bunlar, herhangi bir değişiklik yaptığınızda izleyeceğiniz genel adımlardır.

  1. Araçlar bölümündeki bağlantıları kullanarak Git ve Node'u yükleyin.
  2. Depoyu çatallayın ve klonlayın. GitHub'da depo çatallama hakkında harika bir eğitim bulunmaktadır. Bu kodu Blockly'ye uygulamak için octocat/Spoon-Knife ifadesinin tüm örneklerini, hangi depoda çalışmak istediğinize bağlı olarak RaspberryPiFoundation/blockly veya RaspberryPiFoundation/blockly-samples ile değiştirmeniz yeterlidir.
  3. Fork'unuzu senkronize edin. GitHub, fork'u senkronize etme ile ilgili bir eğitim de sunar.
  4. Ana şubeye göz atın. Blockly Core'da bu, develop dalıdır. blockly-samples'da bu, master dalıdır.
  5. Kök dizinde npm install komutunu çalıştırarak bağımlılıkları ve derleme araçlarını yükleyin.
  6. Bir terminalde git checkout -b myBranchName komutunu çalıştırarak yeni bir dal oluşturun. Ad, üzerinde çalıştığınız şeyi hatırlamanıza yardımcı olmalıdır.
  7. Değişikliklerinizi yapın.
  8. Değişikliklerinizi doğrulayın. Temel veya örnekler ile ilgili kılavuzu inceleyin.
  9. git commit -am "fix: My commit message" simgesini kullanarak değişikliklerinizi kaydedin. Commit mesajları hakkında daha fazla bilgi edinin.
  10. git push origin myBranchName ile değişikliklerinizi GitHub'a gönderin.
  11. Kodunuz hazır olduğunda çekme isteği açın. Blockly ekibinden bir üye, değişikliklerinizi inceleyip onaylanması durumunda Blockly'ye ekler. Daha fazla bilgi için PR Review Process (PR İnceleme Süreci) başlıklı makaleye bakın.