İçeriğe geç
zeev1.0.0-rc.1

Compiler semantic değişiklik beyanı

Depodaki docs/compiler-semantic-degisiklik-beyani.md belgesinden Zee ile üretildi.

compiler/src altındaki her commit, başlığından bağımsız olarak semantic etkisini açıkça bildirir. Kapının makine-okunur kaynağı compiler-degisiklik-beyanlari-v1.tsv, mimari kararı ADR-053'tür. K-160A sonrasında bu beyan tek başına feature izni değildir; ikinci kapı core freeze beyanıdır.

Satır sözleşmesi

Her veri satırı dört sekmeli alan taşır:

  1. kaynak değişikliğinin tam 40 haneli Git SHA'sı;
  2. semantic-bugfix, semantic-change veya maintenance sınıfı;
  3. kanıt;
  4. en az 40 karakterlik, incelemede anlamlı gerekçe.
SınıfKanıtAnlam
semantic-bugfixregression/v2.tsv vaka kimliğiVakanın fixed_by alanı commit SHA'sıyla exact eşleşir.
semantic-changespec/, rfcs/ veya adr/ Markdown yoluKullanıcıya görünen semantic değişiklik normatif karara bağlıdır.
maintenance-Semantic davranış değişmemiştir; gerekçe bunun nedenini açıklar.

İki commitlik akış

  1. Kaynak düzeltmesini testleri ve ilgili davranış belgeleriyle commit et.
  2. Tam SHA'yı al.
  3. Bug fix ise minimal regression fixture'ını ve fixed_by satırını ekle.
  4. Beyan TSV'sine SHA+sınıf+kanıt+gerekçe satırını ekle ve ikinci commit'i al.
  5. Koruk ile tam faz matrisini çalıştır.
bash
bash scripts/semantic-regresyon-korugu.sh HEAD~2
cd compiler
cargo run --locked --bin faz_test_matrisi -- --denetle \
  --rapor target/faz-test-matrisi.md

maintenance kolay kaçış değildir: her commit yine exact ve tekil kayıttır; gerekçe review edilir. Yanlış sınıflandırma, kod incelemesinde semantic bug sayılır. Koruk; eksik/yinelenen satırı, bozuk kanıtı ve kaynak commit'i olmayan sahipsiz beyanı otomatik reddeder.

Core freeze kapısı semantic sınıfı freeze sınıfıyla çapraz denetler: semantic-change, dogfood/security/correctness kanıtı olmadan geçemez.

Kaynak: docs/compiler-semantic-degisiklik-beyani.md · Bütün belgeler