Mulai berkontribusi ke Blockly

Blockly bersifat open source dan sebagian besar dikelola oleh tim kecil. Kami menyambut kontribusi dari developer di luar tim inti; kami tidak dapat mem-build setiap fitur yang diminta atau memperbaiki setiap bug yang dilaporkan tanpa komunitas kami. Bagian ini berisi panduan umum yang mungkin berguna bagi Anda, terutama jika Anda baru mengenal pengembangan open source.

Untuk informasi khusus Blockly yang harus Anda baca sebelum membuat kontribusi, lihat bagian Berkontribusi pada Core dan Berkontribusi pada Sample.

Repositori mana?

Repositori berisi semua file untuk satu project. Blockly memiliki dua repositori: blockly core dan blockly-samples.

Blockly core adalah repositori untuk library Blockly. Gunakan repositori ini jika Anda ingin membuat perubahan pada perilaku inti Blockly dengan cara yang akan berlaku untuk semua pengguna library.

Contoh Blockly adalah repositori untuk contoh, plugin, dan codelab. Gunakan repositori ini jika Anda ingin membuat atau mengubah plugin; menulis codelab; atau membuat atau mengubah contoh.

Langkah demi langkah

Berikut adalah langkah-langkah umum yang akan Anda ikuti setiap kali melakukan perubahan.

  1. Instal Git dan Node, dengan mengikuti link di bagian Alat.
  2. Lakukan fork dan clone repositori. GitHub memiliki tutorial yang bagus tentang membuat fork repo. Untuk menerapkannya ke blockly, cukup ganti setiap instance octocat/Spoon-Knife dengan google/blockly atau google/blockly-samples, bergantung pada repositori yang ingin Anda gunakan.
  3. Sinkronkan fork Anda. GitHub juga menyediakan tutorial untuk menyinkronkan fork.
  4. Lihat cabang utama. Di blockly core, ini adalah cabang develop. Di blockly-samples, ini adalah cabang master.
  5. Instal dependensi dan alat build dengan menjalankan npm install di direktori root.
  6. Buat cabang baru dengan menjalankan git checkout -b myBranchName di terminal. Nama ini akan membantu Anda mengingat apa yang sedang Anda kerjakan.
  7. Buat perubahan.
  8. Validasi perubahan Anda, dengan mengikuti panduan untuk inti atau sampel.
  9. Simpan perubahan dengan git commit -am "fix: My commit message". Baca selengkapnya tentang pesan commit.
  10. Kirim perubahan Anda ke GitHub dengan git push origin myBranchName.
  11. Buka permintaan pull jika kode Anda sudah siap. Anggota tim Blockly akan meninjau perubahan Anda dan menggabungkannya ke Blockly jika disetujui. Untuk mengetahui informasi selengkapnya, lihat Proses Peninjauan PR.