Mulai Berkontribusi ke Blockly

Blockly adalah open source dan dikelola terutama oleh tim kecil. Kami menerima kontribusi dari developer di luar tim inti; tidak ada cara bagi kami untuk membuat 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 mengetahui informasi khusus terkait Blockly yang harus Anda baca sebelum memberikan kontribusi, lihat bagian Berkontribusi pada Core dan Berkontribusi pada Sampel.

Repositori mana?

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

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

Contoh blokly adalah repositori untuk contoh, plugin, dan codelab. Gunakan repositori ini jika Anda ingin membuat atau memodifikasi plugin; menulis codelab; atau membuat atau memodifikasi sampel.

Langkah demi langkah

Ini adalah langkah-langkah umum yang akan Anda ikuti setiap kali Anda membuat perubahan.

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