Panduan Mencapai Keputusan Berkelanjutan

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

Kami memperoleh pelajaran berikut dalam pekerjaan kami yang dapat berfungsi sebagai panduan dan penilaian untuk mencapai keputusan yang berkelanjutan:

Gunakan pendekatan ramping/minimalis untuk dokumentasi keputusan awal.
Prioritaskan dan catat semua keputusan penting yang cukup relevan untuk didokumentasikan dan untuk memahami arsitektur target.
Rincikan keputusan yang sangat penting dengan templat lengkap hanya setelah pekerjaan awal selesai (yaitu, ketika para pengambil keputusan puas dengan keputusan arsitektur yang dibuat dan yakin bahwa keputusan tersebut tidak perlu direvisi dalam waktu dekat).
Gunakan versi ramping/minimalis dari langkah 1 sebagai versi singkat dari keputusan yang terdokumentasi dengan tingkat granularitas yang tepat untuk memberikan gambaran umum keputusan yang rinci, serta untuk keputusan yang sepele atau jelas.
Sedapat mungkin, gunakan pengetahuan arsitektur yang ada, baik dari model panduan maupun dari sumber lain. Tinjau dan perluas pengetahuan tersebut dan sesuaikan dengan konteks keputusan tertentu.
Pastikan tautan keterlacakan terjalin antara keputusan dan baik persyaratan maupun desain/kode arsitektur.
Sediakan pemeriksaan konsistensi otomatis untuk memastikan tautan keterlacakan tetap sinkron setelah terjadi perubahan. Batasi jumlah dependensi antara keputusan dan artefak perangkat lunak lainnya.
Terapkan panduan untuk justifikasi secara konsisten dan tegas, karena justifikasi adalah bagian terpenting dari dokumentasi keputusan karena memberikan alasan.