EN: Read in English
Dunia 1: Titik Simpan
Mesej commit yang bagus
Anda akan belajar: cara tulis mesej commit yang masih jelas bulan depan.
Teks BM belum disemak oleh penutur asli.
Masalahnya
Sebulan kemudian, anda baca log anda. Commit (titik simpan) mana yang tambah laman about? Tiada siapa tahu. Anda pun tak tahu.
Tengok
Mesej commit yang bagus sebut apa yang berubah. Pastikan pendek: cuba 50 aksara atau kurang.
Tengok
Mulakan dengan kata kerja, macam memberi arahan: Add, Fix, Remove. Ia patut melengkapkan ayat “This commit will…”. Tak perlu titik di hujung.
Cuba
Nilai setiap mesej. Leret ke kanan kalau bagus, ke kiri kalau perlu dibaiki.
Leret ke kanan untuk bagus, ke kiri untuk perlu baiki. Atau guna butang.
Add contact formTengok
Banyak pasukan letak label di depan. feat: untuk ciri baru. fix: baiki pepijat. docs: untuk penulisan. Gaya ini dipanggil Conventional Commits (gaya mesej berlabel).
Semak
Anda baiki salah taip di laman about. Pilih mesej terbaik.
Pilih satu jawapan.
Cuba
Simpan about.html dengan mesej yang kemas.
- Kosong
- 3 titik simpan
- Add purple style
- Add home page
- Add README
Petunjuk
Tersilap guna mesej kabur macam “update”? Tekan “Mula semula” (↺) dan cuba lagi.Anda berjaya!
Kini anda boleh tulis mesej commit yang masih jelas kemudian hari.
Nak tahu lebih (pilihan)
Label lain yang anda akan jumpa: style:, refactor:, test: dan chore:. Perlu lebih butiran? Tambah -m kedua untuk isi yang lebih panjang. Pasukan pilih satu bahasa untuk mesej. Bahasa Inggeris biasa digunakan, tapi Bahasa Melayu pun boleh.
English
A month later, you read your log. Which commit added the about page? Nobody knows. Not even you.
A good commit message says what changed. Keep it short: aim for 50 characters or less.
Start with an action word, like an order: Add, Fix, Remove. It should finish the sentence “This commit will…”. Skip the full stop.
Judge each message. Swipe right if it is good, left if it needs work.
Many teams add a label in front. feat: is a new feature. fix: repairs a bug. docs: is for writing. This style is called Conventional Commits.
You fixed a typo on the about page. Pick the best message.
Save about.html with a clean message.
You can now write commit messages that make sense later.
Anda dah siapkan ini. Latihan lagi pun bagus!
Dokumentasi rasmi: git commit (perbincangan tentang mesej) · Conventional Commits
Anda dah belajar 25 minit. Rehat sekejap bantu otak anda.
Pecutan selesai! Fokus yang hebat. Regangkan badan seminit?