FDS-Dev duyuruldu — İngilizce dışındaki dilleri kullanan geliştiriciler için doküman linting + yapay zeka çevirisini bir araya getiren araç

FDS-Dev duyuruldu — İngilizce dışındaki dilleri kullanan geliştiriciler için doküman linting + yapay zeka çevirisini bir araya getiren araç

🤔 Açık kaynak dünyasında İngilizce dışındaki dilleri kullanan geliştiricilerin en büyük engellerinden biri, dokümantasyonu İngilizce yazmak.

Koda güveniyor olsanız da README, yorumlar ve dokümantasyonu İngilizce toparlamaya çalışırken bir anda eliniz durabiliyor.
Yapay zeka çevirmenlerinden yardım alabileceğimiz bir döneme geldik ama

“Bu gerçekten doğal bir ifade mi?”
“Vermek istediğim anlam doğru şekilde aktarılmış mı?”

Böyle kaygıları yaşayan çok kişi vardır.

Ben de 15 yılı aşkın süredir yurt dışında geliştirici olarak çalışıyorum ama
hâlâ en doğal olanı Korece düşünüp yazmak.
Bu yüzden geliştirmeye odaklanınca yorumlar bir bakmışsınız Korece kalmış oluyor; dokümantasyonu düzenlemeye çalışırken de

“Bunu şimdi yayınlarsam doküman kalitesine önem vermeyen bir geliştirici gibi mi görünürüm…”

Diye tereddüt ettiğim çok oldu.

Bu tür kaygılar üzerine, benim gibi İngilizce dışındaki dilleri kullanan geliştiricilerin yükünü biraz olsun hafifletecek bir araç olsa ne iyi olur diye düşündüm.

Ve yaptım.

---

💡 Mevcut linter'ların sınırı: “Harikalar ama İngilizce merkezliler”

Zaten çok iyi doküman kalite denetim araçları var.

• 🔺 markdownlint → Markdown sözdizimi ve stil denetimi
• 🔺 Vale → ton, terim tutarlılığı ve üslup kılavuzu denetimi

Bu araçlar GitHub doküman kalitesini korumakta çok güçlü.
Ama sorun şu: Bu araçlar İngilizce konuşan geliştiriciler varsayılarak tasarlanmış.

Kore, Japonya, Almanya, Çin gibi İngilizce dışındaki ülkelerdeki geliştiriciler dokümanı kendi dillerinde yazdığında:

• lint düzgün çalışmıyor
• stil kılavuzları İngilizce cümleleri temel alıyor
• çeviri/çok dilli ortamlar hesaba katılmıyor

Sonuçta geriye “bunu yeniden İngilizce yazma yükü” kalıyor.

---

🚀 Bu yüzden FDS-Dev'i yaptım

✨ 1) Ultra hızlı, yapı tabanlı doküman linter'ı

Basit stil denetiminin ötesinde:

• ▪️ bölüm sırası
• ▪️ zorunlu başlıklar
• ▪️ dokümanın genel yerleşimi

Gibi profesyonel doküman yapısını da otomatik olarak denetliyor.

✨ 2) Yapay zeka tabanlı, kodu tanıyan çevirmen

Doküman, yorum ve docstring çevirirken:

• ▪️ kod bloklarını korur
• ▪️ CamelCase / snake_case yapısını korur
• ▪️ teknik terimleri doğru biçimde muhafaza eder

Ana dilinizde yazılmış dokümanları üretim seviyesinde İngilizce dokümana otomatik olarak dönüştürür.

✨ 3) İngilizce dışındaki dilleri kullanan geliştiriciler için ilk “kod seviyesinde uluslararasılaştırma” aracı

Artık dokümanı İngilizce yazmak zorunda kalmadan,
dünyanın her yerinden herkesin anlayabileceği dokümanlar oluşturabilirsiniz.

---

⚙️ Basit kullanım

pip install --upgrade fds-dev  
fds translate README.ko.md --output README.md  
fds lint README.md  
DeepL, LibreTranslate 등 다양한 번역 백엔드 선택 가능하며  
GitHub Actions · Docker 환경도 완벽 지원합니다.  

---

🌏 Açık kaynağa katkıda bulunun

FDS-Dev şu anda da hızla gelişiyor.
Sizin ⭐ Star'ınız, Issue'nuz ve PR'ınız bu projenin yönünü belirliyor.

🙌 İngilizce dışındaki dilleri kullanan geliştiriciler için yeni bir standart oluşturmak istiyorum

Dokümantasyon yükü olmadan koda odaklanılabilen bir ortam,
dil engeli olmadan küresel açık kaynağa katkı sunulabilen bir ekosistem—

Umarım FDS-Dev bunun başlangıç noktası olur.
İlginiz ve katılımınız için teşekkürler!

[flamehaven01]

🔥 FDS-Dev v0.0.4 — bugünkü güncelleme haberini paylaşıyorum

FDS-Dev’i gerçek kullanımda geliştirmeye devam ediyorum.
Bugün yayınladığım v0.0.4 (2025-12-08) güncellemesinin içeriğini kısaca paylaşıyorum.

✅ Başlıca değişiklikler

Config yorumlama mantığı iyileştirildi
Artık lint/translate çalıştırma konumunu temel alarak .fdsrc.yaml dosyası otomatik olarak aranıyor.
Klasör bazlı ayarları değiştirseniz bile cd ile dizin değiştirmeden anında uygulanıyor.

Çeviri pipeline’ının kararlılığı artırıldı
language: auto kullanılırken dil nesnesinin eksik olmasından kaynaklanan çökme engellendi.
DeepL için varsayılan 5 saniyelik timeout ve açık hata mesajları eklenerek CLI hang sorunu çözüldü.

Kod kalitesi düzenlemeleri
Modüllerin genelinde satır sonları normalize edildi, trailing whitespace kaldırıldı ve asgari docstring eklendi.
Projeye özel .pylintrc eklenerek Black/Ruff stiliyle çakışmadan yalnızca “gerçek hatalar”ın yakalanması sağlandı.

🧪 Testler

pytest ile 110 test geçti

pylint fds_dev 10.00/10 puana ulaştı

Bu projeyi “küçük dil tabanlı doküman/kod kalite otomasyon aracı” olarak büyütüyorum
ve her gün commit atarak kararlılığı ve mühendislik kalitesini istikrarlı biçimde yükseltiyorum.

İlginizi çekerse repoya göz atın:
https://github.com/flamehaven01/FDS-Dev

Gerekli gördüğünüz özellik önerileri veya issue’lar da her zaman memnuniyetle karşılanır!

[flamehaven01]

v0.0.3 sürümünü yayımladım. Bu güncelleme, güvenliği ve mühendislik kalitesini önemli ölçüde güçlendirmeye odaklandı.

Başlıca değişiklikler şunlar:

Güvenlik: SECURITY.md, zafiyet raporlama süreci, haftalık Dependabot güncellemeleri, secret scanning, branch protection, güvenlik kontrol listesi eklendi

Mühendislik kalitesi: pre-commit hook'ları (black/ruff/isort/yamllint/detect-secrets), CI test kapsamı %70 olarak zorunlu kılındı, mypy(strict), tüm araç yapılandırmaları pyproject.toml altında birleştirildi

CI/CD: kapsam raporu, type checking ve çoklu lint entegrasyonu

Dokümantasyon: Docker/Kubernetes/monorepo pattern'lerini içeren kurumsal dağıtım rehberi, 10 dakikalık eğitim güncellendi

Örnek kod: temel/ileri seviye örnekler eklendi

Depodaki genel kalite skoru %10 → %72.5 olarak iyileştirildi.

Sürüm notları: https://github.com/flamehaven01/FDS-Dev/releases/tag/v0.0.3

Geri bildirimler her zaman memnuniyetle karşılanır.

[dntjrdl]

MIT lisanslı açık kaynak bir proje ha :) Böyle projeler her zaman memnuniyetle karşılanır.

[flamehaven01]

Olumlu değerlendirmeniz için teşekkür ederim! 🙂
Bunu MIT lisansıyla sürdürmemizin nedeni de, herkesin özgürce alıp kullanabilmesi ve bunu kendi ekip ya da şirket ortamına uygun şekilde geliştirebilmesidir.

Özellikle bu v0.0.3 sürümünde güvenlik ve mühendislik temelini büyük ölçüde güçlendirdiğimiz için
küçük bireysel projelerden kurumsal ortamlara kadar rahatlıkla kullanabileceksiniz.

Kullanırken aklınıza gelen geliştirme fikirleri ya da öneriler olursa lütfen istediğiniz zaman paylaşın! 🙌