Catatan rilis adalah jembatan kecil antara penerapan dan orang-orang yang menggunakan produk. Terjemahkan detail implementasi ke dalam perubahan yang dapat dilihat oleh pembaca, dan bedakan kemampuan baru dari perbaikan atau tindakan yang diperlukan.
Jawab pertanyaan pembaca
- Apa yang berubah pada produk atau alur kerja?
- Siapa yang dapat menggunakan perubahan tersebut, dan apakah perubahan tersebut sudah tersedia di semua tempat?
- Apakah pembaca perlu memperbarui, memigrasikan data, atau mengubah pengaturan?
Akurat tentang ketersediaan
Gunakan bahasa yang sederhana dan hindari menjanjikan tanggal atau hasil peluncuran yang belum dikonfirmasi. Sebutkan batasan yang memengaruhi cara seseorang menggunakan fitur tersebut.
Mintalah rekan satu tim di luar implementasi untuk meninjau catatan tersebut. Jika mereka tidak tahu apa yang berubah atau apa yang harus dilakukan selanjutnya, revisi penjelasannya sebelum dipublikasikan.