Skip to main content
Selamat datang di panduan kolaborasi proyek infrastructure as code Biznet GIO. Semua yang ada di proyek ini open source, dan section ini ngajarin lu persis gimana cara bantu: apa yang ada di mana, gimana tiap bagian kerjanya, konvensi apa yang harus diikutin, gimana buka issues dan pull request, dan gimana pipelines ngejaga tiap perubahan tetap aman.
Lu gak butuh pengalaman Terraform, Pulumi, atau Go dulu buat berkontribusi. Halaman Apa itu Infrastructure as Code? ngejelasin dasarnya, dan tiap guide di bawah ini cuma ngasumsi pengetahuan ilmu komputer umum. Semua yang ada di repo-nya sendiri dikomen dalam Bahasa Inggris dan Bahasa Indonesia karena alasan yang sama.

​
Peta proyek

Proyek ini terdiri dari lima repository. Mereka nyambung kayak rantai: dua provider yang ngobrol sama API Biznet GIO, dua repo contoh yang nunjukin tiap fitur provider itu jalan, dan satu situs docs yang ngajarin dua-duanya. Section Contribute ini ngurusin tiga repo yang bisa lu ubah tanpa pengetahuan provider yang dalam: situs docs dan dua repo contoh. Dua repo provider itu codebase Go dengan alur development mereka sendiri; kalau lu nemu bug provider, laporin sebagai issue di repo provider dan biasanya dibenerin di situ duluan.

​
Gimana repo-repo saling komunikasi

Tiga repo itu terus-terusan ngerujuk satu sama lain, dan wiring itu bagian dari desainnya:
  • Repo contoh nge-link ke tutorial situs docs yang ngejelasin pattern yang mereka pake, kayak tutorial Capstone.
  • Situs docs nge-link ke repo contoh di halaman examples, di menu sidebar GitHub, dan dari halaman reference.
  • Halaman reference situs docs nunjukin code yang harus cocok sama yang provider dan contoh lakuin beneran. Pas contoh nemu mismatch, contoh dan docs dua-duanya dibenerin bareng.
Poin terakhir itu penting banget. Repo ini udah nangkep bug asli di docs dengan compile tiap contoh pake SDK aslinya, contohnya keanehan GPU keypair id. Kontribusi lu harus ngejaga loop itu tetap jalan: code dulu, docs kedua, dua-duanya konsisten.

​
Urutan baca

Ikutin urutan ini kalau lu baru di sini:
  1. Gimana repo-repo diorganisir biar tau semua ada di mana.
  2. Setup lokal buat dapetin tools dan token yang lu butuhin.
  3. Konvensi buat belajar aturan rumah sebelum lu nulis apa pun.
  4. Commits dan pull requests buat belajar alur kontribusinya.
  5. Issues dan CODEOWNERS dan reviews buat belajar gimana komunikasi dan review jalan.
  6. Pipelines buat ngerti safety net yang tiap perubahan lewatin.
  7. Deep dive repo, Terraform dan Pulumi, buat ngerti code-nya sendiri, plus complete code walkthrough buat referensi file per file yang lengkap.
  8. Walkthroughs step-by-step pas lu siap bikin perubahan pertama.

​
Standar yang proyek ini ikutin

Tiap konvensi yang proyek ini pake itu standar yang dipublikasiin. Halaman-halaman di atas nge-link ke sumber kanonik buat masing-masing, tapi ini tiga yang paling gede duluan:

Conventional Commits

Tiap pesan commit ngikutin spec ini, yang sama kayak yang dipake kebanyakan proyek open source gede.

GitHub Flow

Fork, branch dari main, buka pull request, review, merge. Gak ada yang lebih ribet dari itu.

GitHub issue forms dan CODEOWNERS

Issue templates, pull request templates, dan aturan kepemilikan semuanya dikonfigurasi per repo di .github.
Tiap repo juga punya CONTRIBUTING.md di root-nya yang ngerangkum aturannya sendiri dan nge-link balik ke sini: