Mulai berkontribusi ke Blockly

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

Untuk informasi khusus Blockly yang harus Anda baca sebelum memberikan kontribusi, lihat bagian Berkontribusi ke Core dan Berkontribusi ke Contoh.

Repositori yang 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 diterapkan kepada 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 Anda melakukan perubahan.

  1. Instal Git dan Node, dengan mengikuti link di bagian Alat.
  2. Lakukan fork dan clone repositori. GitHub memiliki tutorial yang sangat bagus tentang membuat fork repo. Untuk menerapkannya ke blockly, cukup ganti setiap instance octocat/Spoon-Knife dengan RaspberryPiFoundation/blockly atau RaspberryPiFoundation/blockly-samples, bergantung pada repositori yang ingin Anda gunakan.
  3. Sinkronkan fork Anda. GitHub menyediakan tutorial untuk menyelaraskan fork juga.
  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 core atau samples.
  9. Simpan perubahan Anda 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. Open a pull request saat 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.