Enam bulan selepas pelancaran, seseorang bertanya mengapa laman menggunakan dua perkhidmatan untuk tugas yang kelihatan sama. Jawapan yang tinggal ialah “dulu memang buat begitu”. Mungkin ada sebab yang baik, tetapi ia tidak pernah dicatat. Akhirnya pasukan mengulang perbincangan lama dari awal.
Nota keputusan tidak perlu menjadi dokumen sepuluh halaman. Tulis masalah, pilihan yang dipertimbang, keputusan, alasan dan perkara yang boleh membuat keputusan itu berubah. Sertakan tarikh serta orang yang terlibat. Jika pilihan dibuat kerana bajet atau masa ketika itu, nyatakan dengan jujur; konteks tersebut penting apabila keadaan berubah.
Simpan dekat dengan kerja
Untuk keputusan teknikal, fail ringkas dalam repository memudahkan orang menemuinya bersama kod. Untuk keputusan produk, pautkan nota pada tiket atau ruang dokumen yang pasukan memang gunakan. Jangan cipta tempat simpanan baharu jika tiada siapa akan mencarinya. Semak keputusan besar apabila anda membuat migrasi atau menerima keperluan baharu.
Nota keputusan juga patut menyebut pilihan yang ditolak. Jika pasukan memilih laman statik kerana editor hanya seorang, catat bahawa CMS berantaramuka tidak diperlukan ketika itu. Apabila penulis bertambah, orang baharu boleh melihat bahawa keputusan lama dibuat dengan konteks tertentu, bukan kerana pasukan tidak mengenali pilihan lain.
Dokumen seperti ini tidak bertujuan mempertahankan keputusan lama selama-lamanya. Ia membantu generasi pasukan berikutnya menilai sama ada alasan dahulu masih berlaku. Menukar keputusan berdasarkan bukti baharu ialah perkembangan, bukan pengakuan bahawa orang sebelumnya gagal.