> Terim
decision record
Önemli bir mimari veya teknik kararı, bağlamı ve kabul edilen ödünleşimleriyle birlikte kayıt altına alan resmi doküman.
Detaylı Açıklama
Mimari Karar Kaydı (ADR), bir ekibin aldığı önemli bir teknik kararı, o anki bağlamı, değerlendirilen alternatifleri ve kabul edilen kısıtları anlatan kısa ve kalıcı bir dokümandır.
Projenin tarihsel hafızası olarak çalışır ve gelecekteki ekiplerin 'bunu neden böyle saçma sapan yapmışlar' diye sormasını veya aynı hataları tekrarlamasını engeller.
Neden Önemli?
Bir kararın arkasındaki mantığı personel sirkülasyonundan korur ve ekiplerin aynı mimari tartışmaları aylar boyunca tekrar tekrar yapmasını durdurur.
Yaygın Hata Senaryosu
Pratik Örnek
Prodüksiyon Yansıması
Git deposunda bulunan ve her büyük teknik kararın açıklandığı numaralandırılmış Markdown dosyalarından oluşan bir `/docs/adrs` klasörü.
Sıkça Sorulan Sorular
decision record kısaca nedir?
Önemli bir mimari veya teknik kararı, bağlamı ve kabul edilen ödünleşimleriyle birlikte kayıt altına alan resmi doküman.
En sık karşılaşılan hata nedir?
Kararların sadece Slack mesajlarında veya sözlü hafızada kalması. İki yıl sonra kimsenin o legacy veritabanını neden seçtiklerini hatırlamaması.
AI Özeti
Önemli bir mimari veya teknik kararı, bağlamı ve kabul edilen ödünleşimleriyle birlikte kayıt altına alan resmi doküman. Bir kararın arkasındaki mantığı personel sirkülasyonundan korur ve ekiplerin aynı mimari tartışmaları aylar boyunca tekrar tekrar yapmasını durdurur.