Architecture Decision Record

Active theme: Light

← dokumen

Saran menulis ADR yang baik

Ciri-ciri ADR yang baik:

  • Alasan: Jelaskan alasan melakukan AD tertentu tersebut. Ini dapat mencakup konteks (lihat di bawah), kelebihan dan kekurangan berbagai pilihan yang mungkin, perbandingan fitur, pembahasan biaya/manfaat, dan lainnya.

  • Spesifik: Setiap ADR sebaiknya membahas satu AD, bukan beberapa AD.

  • Stempel waktu: Tandai kapan setiap butir dalam ADR ditulis. Ini sangat penting untuk aspek yang dapat berubah dari waktu ke waktu, seperti biaya, jadwal, penskalaan, dan sejenisnya.

  • Tidak dapat diubah: Jangan mengubah informasi yang ada dalam ADR. Sebagai gantinya, ubah ADR dengan menambahkan informasi baru, atau gantikan ADR dengan membuat ADR baru.

Ciri-ciri bagian "Konteks" yang baik dalam ADR:

  • Jelaskan situasi organisasi Anda dan prioritas bisnisnya.

  • Sertakan alasan dan pertimbangan berdasarkan komposisi sosial dan keterampilan tim Anda.

  • Sertakan kelebihan dan kekurangan yang relevan, dan jelaskan dengan istilah yang selaras dengan kebutuhan dan tujuan Anda.

Ciri-ciri bagian "Konsekuensi" yang baik dalam ADR:

  • Jelaskan apa yang terjadi setelah keputusan dibuat. Ini dapat mencakup dampak, hasil, keluaran, tindak lanjut, dan lainnya.

  • Sertakan informasi tentang ADR berikutnya. Cukup umum bahwa satu ADR memicu kebutuhan akan ADR lain, misalnya ketika satu ADR membuat pilihan besar yang menyeluruh, yang pada gilirannya menimbulkan kebutuhan akan keputusan-keputusan yang lebih kecil.

  • Sertakan proses tinjauan pascatindakan apa pun. Biasanya tim meninjau setiap ADR satu bulan kemudian, untuk membandingkan informasi ADR dengan apa yang terjadi dalam praktik sebenarnya, agar dapat belajar dan berkembang.

ADR baru dapat menggantikan ADR sebelumnya:

  • Ketika sebuah AD dibuat yang menggantikan atau membatalkan ADR sebelumnya, maka ADR baru harus dibuat