Changelog Thinking
Menulis note perubahan component yang menjelaskan dampak caller, state yang berubah, migration kecil, dan QA yang diperlukan.
Tujuan belajar
- Membedakan perubahan internal dari perubahan component API atau visual contract
- Menulis changelog note yang menyebut impact serta action consumer
- Mencatat story dan state yang perlu direview setelah perubahan
- Menghindari jargon versioning serta release pipeline sebelum dibutuhkan
Isi lesson
5 blok- 1.Tulis perubahan dari dampak consumerBelum selesaiWajib
- 2.Changelog note untuk perubahan ButtonBelum selesaiWajib
- 3.Writing practiceBelum selesaiWajib
- 4.Cek pemahamanBelum selesaiWajib
- 5.RingkasanBelum selesaiWajib
Tulis perubahan dari dampak consumer
WajibChangelog kecil bukan daftar file yang diubah. Ia menjawab: apa berubah, siapa terdampak, apakah caller perlu melakukan sesuatu, state mana yang perlu direview, dan apakah ada migration atau fallback. Perubahan internal seperti memindahkan helper mungkin cukup dicatat di pull request. Perubahan props, default variant, token, focus behavior, atau semantics button dapat mengubah product dan perlu note lebih jelas.
Gunakan bahasa spesifik. Alih-alih Improve Button, tulis bahwa CourseButton sekarang membutuhkan variant eksplisit, default secondary dihapus, stories ditambahkan, dan consumer yang mengandalkan default perlu memilih intent. Catat QA serta debt yang belum selesai. Tujuannya bukan membuat release note panjang, melainkan mencegah perubahan component tersebar tanpa context.
Bagian ini memengaruhi progres lesson.
Changelog note untuk perubahan Button
Wajib## Changed - CourseButton
- CourseButton sekarang memerlukan prop variant: primary | secondary | destructive.
- Default variant sebelumnya dihapus agar intent action terlihat pada setiap caller.
- Stories Primary, Secondary, Destructive, dan Disabled ditambahkan.
Consumer action:
- Perbarui setiap CourseButton agar mengirim variant yang sesuai intent.
- QA action destructive, disabled saat saving, keyboard focus, dan label panjang.
Deferred:
- Loading spinner belum ditambahkan karena belum ada consumer dengan requirement sama.Note menyebutkan perubahan API, alasan, action consumer, QA, dan hal yang sengaja ditunda. Ia tidak berpura-pura sudah menyelesaikan semua design system concern.
Bagian ini memengaruhi progres lesson.
Writing practice
WajibLatihan menulis
Pilih satu component local atau CourseButton. Tulis changelog-style note yang memuat perubahan API atau visual/semantic contract, alasan, caller terdampak, migration action bila ada, stories/state yang harus direview, QA keyboard/accessibility, dan scope yang sengaja ditunda. Jangan hanya menulis nama file atau improve/fix tanpa impact.
Tulis draft dulu sebelum menandai writing practice selesai.
0/650 karakter
Checklist panduan
Checklist ini hanya panduan. Kamu tidak harus mencentang semuanya.
Cek pemahaman
WajibJawab duluCek pemahaman singkat
Changelog note mana paling membantu consumer?
Progres lesson naik setelah jawaban benar.
Ringkasan
Wajib- Changelog note menjelaskan impact consumer, bukan daftar file.
- Props, default, token, semantics, dan focus behavior dapat menjadi perubahan contract.
- Catat migration action, stories/state yang direview, serta scope ditunda.
- Note singkat spesifik lebih berguna daripada klaim improve umum.
- Berikutnya, Uji Kompetensi menggabungkan story, a11y check, export, dan change note.
Bagian ini memengaruhi progres lesson.
Langkah berikutnya
Selesaikan bagian penting lesson ini
Lanjutkan blok wajib berikutnya: Tulis perubahan dari dampak consumer.