Rails’in en yeni (8.1) kılavuz dokümanlarını Türkçeye çevirdim.
(rails.insomenia.com)Aslında eskiden tam bir Rails eskisiydim, sonra frontend stack’leri arasında gidip geldim ama
son zamanlarda yeniden Rails’e döndüm ve gerçekten çok hoşuma gidiyor.
Rails 8 çok daha iyi hale gelmiş; son dönemde DHH’nin videolarını arka arkaya izliyorum.
(DHH bu aralar gerçekten çok aktif. Bol bol tartışma konusu da çıkarıyor haha)
Rails’in resmi kılavuzları gerçekten çok iyi hazırlanmış, ancak
bu yıl çıkan 8 sürümü için Türkçe çeviri dokümanı olmadığını görünce
yapay zekadan yardım alarak çevirmeyi denedim.
claude sonnet 3.5 API kullandım
ve tüm Markdown dosyalarını otomatik çeviren bir Ruby script’i yazdım.
Çeviri için kullandığım Ruby script’ini de windsurf editörüyle birkaç tur karşılıklı deneme yaparak oluşturdum.
Bu script, tek bir Markdown dosyasını uygun parçalara (yaklaşık 50 satır; code block’ları bölmeden)
ayırıp çevirdikten sonra tekrar Türkçe bir Markdown dosyasında birleştiriyor.
API çağrı maliyeti 30 bin wonu biraz geçti ve toplam 3,2 milyon token kullandım.
gpt-4o eski tip makine çevirisine kıyasla çok daha iyi ama hâlâ kulağa doğal gelmeyen yerler var.
claude ise yazıyı gerçekten iyi kuruyor. Code block’ların içindeki kodu çevirmeyip yalnızca yorumları çeviriyor.
Bir insan çevirmen kadar iyi olmayabilir ama benim aylarca tek tek çevirmemden daha iyi bir sonuç verdiğini düşünüyorum.
DeepL’i de düşündüm ama düz metinde iyi olsa da
Markdown ve code block’ları işleme konusunda çok başarılı görünmüyor.
Umarım Rails geliştiricileri için faydalı olur!
6 yorum
Güzel kaynak için teşekkürler. Aralarda çevrilmemesi gereken metinlerin de çevrildiği yerler olsa da genel kalite iyi görünüyor. Acaba çeviri prompt’unu ayrıca ince ayarladınız mı?
i18n sayfasına biraz el atmak gerekecek sanırım, bildirdiğiniz için teşekkürler! Prompt tarafında özel bir püf nokta yok; sadece sonuçların hatalı çıktığı kısımlar için ek promptlar ekledim :)
Windsurf deneyiminiz nasıldı, merak ediyorum
Bu aralar geliştirirken bunu sık kullanıyorum
Ondan önce Cursor, ondan da önce Copilot kullanıyordum ve geliştirme hızı kesinlikle artıyor
%100 kusursuz kod üretmiyor ama sık kullanılan pattern kodlarını iyi yazıyor
Benim o tür kodları doğrudan yazmam saatler alırdı ama yapay zeka onları birkaç saniyede yazıyor
Üniversite öğrencisiyken sanayi-akademi iş birliği kapsamında stajyer olarak girdiğim şirket Rails kullanıyordu; Korece kaynak neredeyse hiç olmadığı için gerçekten zorlanmıştım... O zaman aldığım Rails kitabının da şimdi baskısı tükenmiş.
Her neyse, teşekkürler. Uzun zaman sonra bir göz atmam gerekecek gibi!
Rails ana akım olmasa da yine de İngilizce kaynak epey var; ancak Türkçe gerçekten çok az.
Yapay zeka iyi çeviri yaptığı için talep varsa Rails ile ilgili belgelerin çevirilerini hazırlamayı düşünüyorum