Skenario 1: benerin typo di situs docs
Kontribusi sekecil mungkin, bagus buat belajar alur fork dan PR.1
Fork dan clone
Fork biznetgio-docs kalau lu mau kirim PR, terus clone:Perintahnya clone upstream; buat push branch, clone fork lu dari halaman fork lu, caranya sama.
2
Temuin halamannya dan benerin dua bahasa
Misal typo-nya ada di
/quickstart. Copy Inggris-nya quickstart.mdx, copy Indonesianya id/quickstart.mdx. Benerin Inggris dulu, terus terapin fix yang setara ke halaman Indonesia. Kalau kalimat Indonesianya gak ada persis, benerin maknanya, bukan kata-katanya.3
Preview lokal
4
Commit dan push
5
Buka PR
Buka PR lawan
main upstream. Sebut halaman mana dan bahasa mana. Maintainer squash merge, dan app Mintlify nge-redeploy situs dari main otomatis dalam hitungan menit.Skenario 2: nambah contoh Terraform baru
Misal provider dapet data source baru buat NEO Lite dan lu mau contoh yang nunjukin itu.1
Branch dari main yang fresh
2
Edit contohnya
Kalau data source-nya masuk ke cerita NEO Lite yang udah ada, tambahin ke
neolite/main.tf dengan banner dan komen section bilingual, ngikutin Konvensi. Referensikan dari resource atau output biar bener-bener kepake.3
Validate
4
Update docs dan README di PR yang sama
Tabel README root bilang
neolite/ nge-cover “all 5” data sources; naikin angkanya. Kalau situs docs punya halaman yang nunjukin data source NEO Lite, update terraform/resources/neolite.mdx dan id/terraform/resources/neolite.mdx di repo docs.5
Commit, push, buka PR
Skenario 3: nambah contoh Pulumi baru di TypeScript
1
Copy folder yang paling deket
2
Tulis ulang programnya
Edit
typescript/my-new-thing/index.ts: banner baru, resource baru, aturan yang sama. Set nama project di Pulumi.yaml jadi biznetgio-example-my-new-thing dan benerin field name di package.json biar cocok. Jaga payWithCreditCard default ke false, opsi one-shot dikomen, dan toAccountId di mana pun id ketemu input yang typed number.3
Build dan preview
toAccountId yang kelewat atau properti yang gak ada, kayak keypairId di GpuKeypair. Panduan repo Pulumi nge-list yang udah diketahui.4
Mirror ke lima bahasa lainnya
Copy contoh setara yang udah ada di tiap bahasa dan translate programnya dengan cara yang sama. YAML dapet versi flat. Komen tetep sama semangatnya, format bilingual yang sama di mana-mana.
5
Update README dan CI, terus buka PR
Tabel README root, README per folder, dan tiga titik edit CI dari Pipelines. Terus isi checklist PR dan buka PR lawan
main upstream.Skenario 4: mirror contoh yang udah ada ke bahasa Pulumi baru
Mekanik dari langkah “lima bahasa lainnya” di Skenario 3, dikerjain dengan bener buat satu bahasa:- Pilih bahasa yang lu kuasai dan copy enam folder bahasa yang udah ada, jangan rename apa pun dulu.
- Buat tiap folder, ganti file programnya dengan versi bahasa baru, jaga komen bilingual. Translate strukturnya, jangan pernah ngarang perilaku: resource yang sama, default yang sama, urutan yang sama.
- Tulis file dependency bahasa baru dengan versi pinned dari Konvensi.
- Build tiap folder dengan command bahasanya dari Local setup, benerin type error satu per satu.
- Update README root cuma kalau dia nge-list coverage bahasa, dan tambahin bahasa itu ke CI di tiga tempat yang disebut Pipelines.
Skenario 5: laporin bug yang lu nemuin pas pake contoh
Lu jalaninterraform plan di gpu/ dan dapet error yang gak bisa lu jelasin.
- Cari teks error-nya di issues dan Discussions repo dulu.
- Cek halaman docs buat resource itu; keanehan GPU memang didokumentasiin dengan sengaja.
- Kalau ini hal baru, buka bug issue lewat form laporan bug. Isi folder contoh-nya, versi Terraform lu, command persisnya, output error lengkap, dan apa yang lu harapin.
- Tunggu triage. Kalau maintainer bilang itu bug provider, dia bakal mindahin ke repo provider, dan lu bisa ngikutin fix-nya di situ.
- Kalau lu juga tau fix buat contoh atau docs-nya, bilang di issue, terus kirim PR setelah issue ngekonfirmasi arahnya.
Yang dilakuin pas lu mentok
- Baca ulang Panduan repo Terraform atau Panduan repo Pulumi buat area yang lu sentuh.
- Buka Discussion dengan kode lu sekarang dan error-nya. Itu emang gunanya Discussions.
- Jaga PR tetep draft selagi lu mikirin; thread review itu tempat yang oke buat nanya begitu PR-nya ada.