Skip to main content
Halaman-halaman sebelumnya ngejelasin aturannya. Halaman ini ngubahnya jadi lima run lengkap yang bisa lu ikutin persis, diurutin dari yang paling gampang. Tiap skenario ngasumsi lu udah ngerjain Local setup.

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

Cek dua-dua bahasa pake language switcher di top bar.
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

Ini clone upstream langsung; fork dulu dan clone fork lu kalau mau push branch.
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

Benerin semuanya sampe tiga-tiganya lolos. Kalau provider punya batas nama buat yang lu tambahin, pendekin namanya.
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

Isi checklist template PR dengan jujur, termasuk kotak sinkronisasi README dan docs.

Skenario 3: nambah contoh Pulumi baru di TypeScript

1

Copy folder yang paling deket

Ini clone upstream langsung; fork dulu dan clone fork lu kalau mau push branch.
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

Type error di tahap ini hampir selalu 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:
  1. Pilih bahasa yang lu kuasai dan copy enam folder bahasa yang udah ada, jangan rename apa pun dulu.
  2. 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.
  3. Tulis file dependency bahasa baru dengan versi pinned dari Konvensi.
  4. Build tiap folder dengan command bahasanya dari Local setup, benerin type error satu per satu.
  5. Update README root cuma kalau dia nge-list coverage bahasa, dan tambahin bahasa itu ke CI di tiga tempat yang disebut Pipelines.
Kalau ini bahasa baru total, bukan mirror, buka feature request dulu sesuai Komunikasi.

Skenario 5: laporin bug yang lu nemuin pas pake contoh

Lu jalanin terraform plan di gpu/ dan dapet error yang gak bisa lu jelasin.
  1. Cari teks error-nya di issues dan Discussions repo dulu.
  2. Cek halaman docs buat resource itu; keanehan GPU memang didokumentasiin dengan sengaja.
  3. 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.
  4. Tunggu triage. Kalau maintainer bilang itu bug provider, dia bakal mindahin ke repo provider, dan lu bisa ngikutin fix-nya di situ.
  5. 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.