Templat rekod keputusan untuk Keputusan Teknikal Penting (ITD)

Ini ialah templat Keputusan Teknikal Penting (Important Technical Decisions, ITD) yang diterangkan dalam ITDs: a lean ADR for executive technical decision-making at scale - Ignacio Larrañaga.

ITD ialah evolusi ADR yang berfokus, dioptimumkan untuk kelajuan, kejelasan dan pengesahan eksekutif. Walaupun ADR mendokumenkan apa yang diputuskan, ITD ialah artifak ramping yang mengutamakan keputusan dan menjadikan keputusan itu sendiri boleh disemak, supaya pihak berkepentingan boleh mengimbasnya dengan cepat dan mencabarnya dengan mudah. ITD sesuai untuk keputusan teknikal yang tidak semestinya berkaitan seni bina, seperti memilih model, pustaka atau strategi CI/CD.

Dalam setiap fail ITD, tulis bahagian-bahagian ini:

Tajuk

Nyatakan keputusan itu sendiri, bukan huraian topik. Contohnya, "Gunakan Qwen2.5 1.5B Instruct untuk terjemahan pada peranti".

Masalah

Satu ayat yang menyatakan apa yang cuba kami selesaikan.

Pilihan yang Dipertimbangkan

Alternatif yang ada di atas meja, dengan pilihan yang dipilih dalam teks tebal.

Rasional

Hanya faktor penentu yang membawa kepada pilihan itu, bukan senarai lengkap setiap kebaikan dan keburukan.

Nota

Pilihan. Sebarang konteks tambahan yang wajar direkodkan, seperti kekangan, andaian atau pautan.