Blockly'ye katkıda bulunmaya başlama

Blockly açık kaynaklıdır ve temel olarak küçük bir ekip tarafından yönetilir. Temel ekip dışındaki geliştiricilerin katkılarını memnuniyetle karşılıyoruz. İstekte bulunulan her özelliği geliştirmemiz veya bildirilen her hatayı düzeltmemiz, topluluğumuzun desteği olmadan mümkün değildir. Bu bölümde, özellikle açık kaynak geliştirmeye yeni başladıysanız işinize yarayabilecek genel kılavuzlar yer almaktadır.

Katkıda bulunmadan önce okumanız gereken Blockly'ye özgü bilgiler için Core'a Katkıda Bulunma ve Sana Özel'e 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. Temel Blockly davranışında, kitaplığın tüm kullanıcıları için geçerli olacak şekilde değişiklik yapmak istiyorsanız bu deposu kullanın.

Blockly örnekleri, örneklerin, eklentilerin ve kod laboratuvarlarının deposudur. Eklenti oluşturmak veya değiştirmek, kod deneme çalışması yazmak ya da örnek oluşturmak veya değiştirmek istiyorsanız bu deposu kullanın.

Adım adım

Bunlar, değişiklik yaptığınızda uygulayacağınız genel adımlardır.

  1. Araçlar bölümündeki bağlantıları izleyerek Git ve Node'u yükleyin.
  2. Deposuyu çatallayın ve klonlayın. GitHub'da bir deposu çatallama hakkında harika bir eğitim mevcuttur. Bu değişikliği Blockly'ye uygulamak için, çalışmak istediğiniz depoya bağlı olarak octocat/Spoon-Knife ifadesinin her bir örneğini google/blockly veya google/blockly-samples ile değiştirmeniz yeterlidir.
  3. Çatalınızı senkronize edin. GitHub, çatalları senkronize etme ile ilgili bir eğitim de sunar.
  4. Ana şubeye göz atın. Blockly Core'da bu develop şubesidir. blockly-samples'de bu, master dalıdır.
  5. Kök dizinde npm install'yi çalıştırarak bağımlılıkları ve derleme araçlarını yükleyin.
  6. Terminalde git checkout -b myBranchName komutunu çalıştırarak yeni bir dal oluşturun. Ad, üzerinde çalıştığınız konuyu hatırlamanıza yardımcı olmalıdır.
  7. Değişikliklerinizi yapın.
  8. Temel veya örnek kılavuzunu izleyerek değişiklikleri doğrulayın.
  9. git commit -am "fix: My commit message" ile değişikliklerinizi kaydedin. Taahhüt mesajları hakkında daha fazla bilgi edinin.
  10. git push origin myBranchName ile GitHub'a değişiklikleri gönderin.
  11. Kodunuz hazır olduğunda bir çekme isteği açın. Blockly ekibinin bir üyesi, değişikliklerinizi inceler ve onaylanan değişiklikleri Blockly'ye ekler. Daha fazla bilgi için Halkla İlişkiler İnceleme Süreci başlıklı makaleyi inceleyin.