“Kaynak kod dosyalarını doğrudan bir çeviri aracına eklemek, genellikle değişken adlarının ve mantık anahtar kelimelerinin (if/for) de çevrilmesine ve bu nedenle kodun çalışmaz hale gelmesine yol açmaktadır.”

Kök Neden Analizi

AST (Soyut Sözdizimi Ağacı) düzeyinde algılama

Shangyi AI yalnızca regex eşleştirme ile sınırlı değildir, aynı zamanda hafif bir sözdizimi analizi de gerçekleştirebilir. Python için, `'''...'''` ile çevrelenmiş Docstring'leri hassas bir şekilde algılayabilir; Java/JS için `/**...*/` bloklarını algılayabilir.

Talimat korunur

Yorum bloğu içinde, `@param`, `@return`, `@author` gibi belirli talimatlar için sistem yalnızca talimat başlığını korur ve sonrasındaki açıklayıcı metni çevirir. Bu sayede API belgeleri (ör. Javadoc, Sphinx) oluşturulurken formatın doğruluğu garanti altına alınır.

Nihai Çözüm Özeti

Açık kaynak projelerin hızlı ve çok dilli dokümantasyon oluşturmasını sağlar, dünya genelindeki geliştiriciler için katkıda bulunma eşiğini düşürür.