Architecture Decision Record

Active theme: Light

← Karar kaydı şablonları

Önemli Teknik Kararlar (ITD'ler) için karar kaydı şablonu

Bu, ITD'ler: ölçekte yönetici düzeyinde teknik karar verme için yalın bir MKK - Ignacio Larrañaga yazısında anlatılan Önemli Teknik Kararlar (ITD) şablonudur.

ITD'ler, MKK'lerin hız, açıklık ve yönetici onayı için optimize edilmiş, odaklanmış bir evrimidir. Bir MKK neyin kararlaştırıldığını belgelerken, ITD önce kararı koyan yalın bir artefakttır ve kararın kendisini gözden geçirilebilir kılar; böylece paydaşlar onu hızla tarayabilir ve kolayca sorgulayabilir. ITD'ler, bir model, bir kütüphane veya bir CI/CD stratejisi seçmek gibi kesin olarak mimari olmayan teknik kararlar için çok uygundur.

Her ITD dosyasında şu bölümleri yazın:

Başlık

Konunun bir tanımını değil, kararın kendisini belirtin. Örneğin, "Cihaz üzerinde çeviri için Qwen2.5 1.5B Instruct kullan".

Sorun

Çözmeye çalıştığımız şeyi belirten tek bir cümle.

Değerlendirilen Seçenekler

Masadaki alternatifler; seçilen seçenek kalın yazılır.

Gerekçe

Seçime yol açan yalnızca belirleyici etkenler; her artının ve eksinin kapsamlı bir listesi değil.

Notlar

İsteğe bağlı. Kısıtlamalar, varsayımlar veya bağlantılar gibi kaydedilmeye değer ek bağlam.