Bu rehber K-114/ADR-025'in uygulama yüzeyidir. Amaç, bir çocuğun bugün gördüğü S004 ile yıllar sonra editörün gördüğü S004ün aynı olayı anlatmasını sağlamaktır.
İki bağımsız kapı
compiler/tests/katalog_testi.rs, üretim kaynaklarında doğan kodlarladocs/hata-katalogu.mdkayıtlarını birebir karşılaştırır.compiler/tests/tani_kimligi_testi.rs, katalogdaki her kodun durumunu ve kanonik anlamınıcompiler/tests/fixtures/tani-kimlikleri-v1.tsvile karşılaştırır.
İlk kapı “kod belgeli mi?”, ikinci kapı “bu kod hâlâ aynı şey mi?” sorusunu yanıtlar. Fixture ayrıca semantik anahtarların tekil, küçük ASCII ve doğru ailede olmasını denetler.
Yeni tanı ekleme
- Olayın mevcut bir kodla gerçekten aynı semantik olay olup olmadığını kontrol et. Tüketicinin farklı davranması gerekiyorsa yeni koddur.
- İlgili ailede sıradaki boş kodu seç; ayrılmış kodu geri alma.
- Üretim noktasını, katalog satırını, fixture kaydını ve olumlu/olumsuz davranış testini aynı commit'te ekle.
- Semantik anahtarı aile önekiyle yaz:
soz.,ad.,tur.,calisma.,dogrulama.,proje.veyaic.. Anahtar sonradan yeniden adlandırılmaz. - Katalog özetini olay kimliği olacak kadar kesin, dinamik ayrıntıdan bağımsız tut. Somut ad/değer gibi bağlam
Tani.mesajve öneride kalır.
Kodu emekliye ayırma
Kaynak artık kodu üretmese bile katalog ve fixture satırı silinmez. Katalog özeti **ayrılmış** — ..., fixture durumu ayrilmis olur. Eski semantik anahtar korunur. A004, C014 ve S032 bu mezar taşı davranışının ilk tabanıdır.
Anlam ile metin ayrımı
Yazım, noktalama veya daha doğal Türkçe gibi editoryal bir katalog düzeltmesi fixture özetini de değiştirir; böylece değişiklik kod incelemesinde görünür. Tanının hangi koşulda doğduğu, ailesi veya tüketicinin vereceği karar değişiyorsa bu editoryal değildir ve yeni kod gerekir.
Dinamik mesaj, öneri, satır/sütun ve işaret uzunluğu kimlik fixture'ına konmaz. JSON alan biçimi ve çoklu tanı sırası RFC-0010'un ayrı sözleşmeleridir. Program içinde taşınan yapılandırılmış Hata.kod değerleri de bu derleyici tanı kataloğunun parçası değildir.
Yerel doğrulama
cd compiler
cargo test --test katalog_testi --test tani_kimligi_testiFixture farkını özellikle incele: var olan satırın silinmesi, durumunun ayrilmisten aktife dönmesi veya aynı kodun anlam değiştirmesi sürüm uyumluluğu ihlalidir.
Kaynak: docs/tani-kimligi.md · Bütün belgeler