FDS-Dev dirilis — alat all-in-one linting dokumentasi + terjemahan AI untuk developer non-Inggris

 (github.com/flamehaven01)
9 poin oleh flamehaven01 2025-11-20 | 4 komentar | Bagikan ke WhatsApp

FDS-Dev dirilis — alat all-in-one linting dokumentasi + terjemahan AI untuk developer non-Inggris

🤔 Di dunia open source, salah satu hambatan terbesar yang dirasakan developer non-Inggris adalah menulis dokumentasi dalam bahasa Inggris.

Banyak yang percaya diri dengan kode, tetapi ketika harus merapikan README, komentar, atau dokumentasi dalam bahasa Inggris, tangan jadi ragu bergerak.
Kini memang sudah ada bantuan dari penerjemah AI, tetapi

“Apakah ungkapan ini benar-benar terdengar alami?”
“Apakah maksud yang saya inginkan sudah tersampaikan dengan baik?”

Mungkin banyak dari Anda pernah memikirkan hal seperti ini.

Saya sendiri sudah bekerja sebagai developer di luar negeri selama lebih dari 15 tahun, tetapi
masih merasa berpikir dan menulis dalam bahasa Korea adalah yang paling alami.
Karena itu, saat tenggelam dalam pengembangan, tanpa sadar komentar tetap tertulis dalam bahasa Korea, dan ketika hendak merapikan dokumentasi, saya sering berpikir

“Kalau saya unggah sekarang, nanti saya terlihat seperti developer yang tidak peduli pada kualitas dokumentasi…”

Saya pun sering ragu.

Setelah melalui kegelisahan itu, saya berpikir akan sangat baik jika ada alat yang bisa sedikit meringankan beban developer non-Inggris seperti saya.

Maka saya membuatnya.

💡 Batasan linter yang ada: “Hebat, tetapi berpusat pada penutur bahasa Inggris”

Sudah ada alat-alat pemeriksaan kualitas dokumentasi yang sangat bagus.

  • 🔺 markdownlint → pemeriksaan sintaks dan gaya Markdown
  • 🔺 Vale → pemeriksaan tone, konsistensi istilah, dan panduan gaya penulisan

Alat-alat ini sangat kuat untuk menjaga kualitas dokumentasi di GitHub.
Namun masalahnya adalah, alat-alat ini dirancang dengan asumsi pengguna utamanya adalah developer berbahasa Inggris.

Ketika developer non-Inggris dari Korea, Jepang, Jerman, Tiongkok, dan negara lain menulis dokumentasi dalam bahasa mereka sendiri:

  • lint tidak bekerja dengan baik
  • panduan gaya didasarkan pada kalimat bahasa Inggris
  • lingkungan terjemahan/multibahasa tidak dipertimbangkan

Pada akhirnya, beban untuk “menulis ulang dalam bahasa Inggris” tetap ada.

🚀 Karena itu, lahirlah FDS-Dev

✨ 1) Linter dokumentasi berbasis struktur supercepat

Lebih dari sekadar pemeriksaan gaya sederhana:

  • ▪️ urutan seksi
  • ▪️ header wajib
  • ▪️ layout keseluruhan dokumen

Bahkan struktur dokumentasi profesional seperti ini bisa diperiksa otomatis.

✨ 2) Penerjemah berbasis AI yang memahami kode

Saat menerjemahkan dokumentasi, komentar, dan docstring:

  • ▪️ perlindungan code block
  • ▪️ menjaga CamelCase / snake_case
  • ▪️ mempertahankan istilah teknis secara akurat

Dokumen yang ditulis dalam bahasa ibu dapat diubah otomatis menjadi dokumentasi bahasa Inggris tingkat produksi.

✨ 3) Alat “internasionalisasi level kode” pertama untuk developer non-Inggris

Kini tanpa harus menulis dokumentasi dalam bahasa Inggris,
Anda tetap bisa membuat dokumentasi yang dapat dipahami siapa pun di seluruh dunia.

⚙️ Cara penggunaan sederhana

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

🌏 Berkontribusilah pada open source

FDS-Dev masih terus berkembang dengan cepat.
⭐ Star, Issue, dan PR Anda membantu menentukan arah proyek ini.

🙌 Saya ingin menciptakan standar baru untuk developer non-Inggris

Sebuah lingkungan tempat Anda bisa fokus pada kode tanpa beban dokumentasi,
ekosistem tempat Anda bisa berkontribusi pada open source global tanpa hambatan bahasa—

Saya berharap FDS-Dev bisa menjadi titik awalnya.
Mohon dukungan dan partisipasinya!

Bacaan terkait

4 komentar

 
flamehaven01 2025-12-08

🔥 FDS-Dev v0.0.4 — membagikan kabar pembaruan hari ini

Saya terus menggunakan FDS-Dev secara langsung sambil terus meningkatkannya.
Berikut ringkasan singkat pembaruan v0.0.4 (2025-12-08) yang dirilis hari ini.

✅ Perubahan utama

Peningkatan logika interpretasi config
Sekarang .fdsrc.yaml akan dicari secara otomatis berdasarkan lokasi eksekusi lint/translate.
Meski pengaturan per folder diubah, perubahan akan langsung diterapkan tanpa perlu berpindah cd.

Peningkatan stabilitas pipeline terjemahan
Saat menggunakan language: auto, crash yang sebelumnya terjadi karena objek bahasa tidak ada kini telah dicegah.
DeepL kini memakai timeout bawaan 5 detik + pesan error yang jelas, sehingga masalah CLI hang telah teratasi.

Perapihan kualitas kode
Di seluruh modul, dilakukan normalisasi line ending, penghapusan trailing whitespace, dan penambahan docstring minimum.
.pylintrc khusus proyek telah diperkenalkan agar hanya “error yang benar-benar substantif” yang terjaring, tanpa bentrok dengan gaya Black/Ruff.

🧪 Pengujian

110 pytest lulus

Skor pylint fds_dev mencapai 10.00/10

Saya sedang mengembangkan proyek ini menjadi “alat otomatisasi kualitas dokumen/kode berbasis bahasa berskala kecil”,
dan terus meningkatkan stabilitas serta kualitas engineering dengan commit harian.

Kalau tertarik, silakan lihat repositorinya:
https://github.com/flamehaven01/FDS-Dev

Usulan fitur yang dibutuhkan maupun issue juga selalu saya sambut!
 
flamehaven01 2025-11-20

Saya telah merilis versi v0.0.3. Pembaruan kali ini berfokus pada penguatan keamanan dan kualitas engineering secara signifikan.

Perubahan utama adalah sebagai berikut:

Keamanan: penambahan SECURITY.md, proses laporan kerentanan, pembaruan Dependabot mingguan, secret scanning, branch protection, dan checklist keamanan

Kualitas engineering: pre-commit hooks (black/ruff/isort/yamllint/detect-secrets), penerapan paksa cakupan pengujian CI 70%, mypy(strict), integrasi seluruh konfigurasi tool ke pyproject.toml

CI/CD: integrasi laporan coverage, type checking, dan multi-lint

Dokumentasi: panduan deployment enterprise yang mencakup pola Docker/Kubernetes/monorepo, pembaruan tutorial 10 menit

Contoh kode: penambahan contoh dasar/lanjutan

Skor kualitas seluruh repositori meningkat dari 10% → 72.5%.

Catatan rilis: https://github.com/flamehaven01/FDS-Dev/releases/tag/v0.0.3

Feedback selalu diterima.
 
dntjrdl 2025-11-20

Proyek open source berlisensi MIT ya :) Proyek seperti ini selalu disambut baik.
 
flamehaven01 2025-11-20

Terima kasih sudah melihatnya dengan baik! 🙂
Alasan kami mempertahankannya dengan lisensi MIT juga agar siapa pun bisa bebas menggunakannya dan mengembangkannya sesuai kebutuhan tim atau lingkungan perusahaan mereka.

Terutama di v0.0.3 kali ini, fondasi keamanan/rekayasanya sudah banyak diperkuat, jadi
dari proyek pribadi kecil hingga lingkungan enterprise, Anda bisa memanfaatkannya tanpa beban.

Kalau nanti saat menggunakannya Anda punya ide perbaikan atau saran, jangan ragu untuk memberi tahu kami kapan saja! 🙌