FDS-Dev रिलीज़ — गैर-अंग्रेज़ी भाषी डेवलपर्स के लिए documentation linting + AI translation all-in-one टूल
(github.com/flamehaven01)FDS-Dev रिलीज़ — गैर-अंग्रेज़ी भाषी डेवलपर्स के लिए documentation linting + AI translation all-in-one टूल
🤔 open source दुनिया में गैर-अंग्रेज़ी भाषी डेवलपर्स के लिए सबसे बड़ी बाधाओं में से एक है अंग्रेज़ी में documentation लिखना।
कोड पर भरोसा होता है, लेकिन README, comments या documentation को अंग्रेज़ी में व्यवस्थित करने बैठें तो हाथ अनायास रुक जाता है।
अब AI translators की मदद लेने का समय आ गया है, लेकिन
“क्या यह वाकई स्वाभाविक अभिव्यक्ति है?”
“क्या मेरी मंशा ठीक से पहुँची होगी?”
ऐसी चिंताएँ बहुत से लोगों ने की होंगी।
मैं भी 15 साल से अधिक समय से विदेश में डेवलपर के रूप में काम कर रहा हूँ,
फिर भी सोचना और लिखना अपनी मातृभाषा में ही सबसे स्वाभाविक लगता है।
इसलिए जब विकास कार्य में डूबा रहता हूँ, तो कब comments मातृभाषा में रह जाते हैं, पता नहीं चलता, और जब documentation को व्यवस्थित करने की बारी आती है, तब
“अगर इसे अभी अपलोड कर दूँ, तो कहीं ऐसा न लगे कि मैं documentation की quality की परवाह नहीं करता…”
ऐसा सोचकर मैं कई बार हिचकिचाया हूँ।
इन्हीं चिंताओं के बीच मैंने सोचा कि काश मेरे जैसे गैर-अंग्रेज़ी भाषी डेवलपर्स के लिए ऐसा कोई टूल हो जो यह बोझ थोड़ा कम कर सके।
इसलिए मैंने इसे बनाया।
💡 मौजूदा linters की सीमाएँ: “बेहतरीन हैं, लेकिन अंग्रेज़ी-केंद्रित”
documentation quality जाँचने के बेहतरीन टूल पहले से मौजूद हैं।
- 🔺 markdownlint → Markdown syntax और style जाँच
- 🔺 Vale → tone, terminology consistency, और writing guide जाँच
ये टूल GitHub documentation quality बनाए रखने में बेहद शक्तिशाली हैं।
लेकिन समस्या यह है कि ये टूल अंग्रेज़ी भाषी डेवलपर्स को ध्यान में रखकर डिज़ाइन किए गए हैं।
जब कोरिया, जापान, जर्मनी, चीन आदि के गैर-अंग्रेज़ी भाषी डेवलपर्स अपनी भाषा में documentation लिखते हैं:
- lint सही तरह से काम नहीं करता
- style guides अंग्रेज़ी वाक्य संरचना पर आधारित होते हैं
- translation / multilingual environment को ध्यान में नहीं रखा जाता
आख़िरकार “इसे फिर से अंग्रेज़ी में लिखना पड़ेगा” वाला दबाव बना रहता है।
🚀 इसलिए बनाया FDS-Dev
✨ 1) बेहद तेज़ structure-based documentation linter
सिर्फ़ साधारण style checks से आगे बढ़कर:
- ▪️ section order
- ▪️ required headers
- ▪️ पूरे document का layout
जैसी पेशेवर documentation structure तक की अपने-आप जाँच करता है।
✨ 2) AI-आधारित code-aware translator
documentation, comments और docstrings का अनुवाद करते समय:
- ▪️ code blocks की सुरक्षा
- ▪️ CamelCase / snake_case को संरक्षित रखना
- ▪️ technical terms को सटीक रूप से बनाए रखना
मातृभाषा में लिखे गए documents को production-level अंग्रेज़ी documentation में अपने-आप बदल देता है।
✨ 3) गैर-अंग्रेज़ी भाषी डेवलपर्स के लिए पहला “code-level internationalization” टूल
अब documentation अंग्रेज़ी में लिखना अनिवार्य नहीं है,
फिर भी ऐसा documentation बनाया जा सकता है जिसे पूरी दुनिया समझ सके।
⚙️ आसान उपयोग
pip install --upgrade fds-dev
fds translate README.ko.md --output README.md
fds lint README.md
DeepL, LibreTranslate 등 다양한 번역 백엔드 선택 가능하며
GitHub Actions · Docker 환경도 완벽 지원합니다.
🌏 open source में योगदान दें
FDS-Dev अभी भी तेज़ी से विकसित हो रहा है।
आपका ⭐ Star, Issue, और PR इस project की दिशा तय करते हैं।
🙌 मैं गैर-अंग्रेज़ी भाषी डेवलपर्स के लिए एक नया मानक बनाना चाहता हूँ
ऐसा माहौल जहाँ documentation का बोझ लिए बिना कोड पर ध्यान केंद्रित किया जा सके,
और ऐसी ecosystem जहाँ भाषा की बाधा के बिना global open source में योगदान दिया जा सके—
उम्मीद है FDS-Dev उसकी शुरुआत बनेगा।
कृपया बहुत रुचि और भागीदारी दिखाएँ!
4 टिप्पणियां
🔥 FDS-Dev v0.0.4 — आज के अपडेट की जानकारी साझा कर रहा हूँ
मैं FDS-Dev को लगातार वास्तविक उपयोग में रखते हुए बेहतर बना रहा हूँ।
आज जारी किए गए v0.0.4 (2025-12-08) अपडेट की बातें संक्षेप में साझा कर रहा हूँ।
✅ मुख्य बदलाव
Config parsing logic में सुधार
अब यह
lint/translateचलाने की लोकेशन के आधार पर.fdsrc.yamlको अपने-आप खोजता है।अब फ़ोल्डर-स्तर की settings बदलने पर
cdसे इधर-उधर जाए बिना तुरंत असर दिखेगा।Translation pipeline की stability बेहतर
language: autoइस्तेमाल करने पर language object missing होने से जो crash होता था, उसे रोका गया है।DeepL में 5 सेकंड का default timeout और साफ़ error message जोड़ा गया है, जिससे CLI hang की समस्या हल हुई है।
Code quality में सुधार
पूरे module में line ending normalization, trailing whitespace removal, और न्यूनतम docstring जोड़े गए हैं।
प्रोजेक्ट-विशेष
.pylintrcजोड़ा गया है ताकि Black/Ruff style से टकराव बिना सिर्फ “वास्तविक errors” ही पकड़े जाएँ।🧪 टेस्ट
pytestके 110 टेस्ट पासpylint fds_devमें 10.00/10 स्कोर हासिलमैं इस प्रोजेक्ट को “छोटे भाषा-आधारित document/code quality automation tool” के रूप में विकसित कर रहा हूँ,
और हर दिन commit करते हुए इसकी stability और engineering quality को लगातार बेहतर बना रहा हूँ।
अगर रुचि हो तो repository देखिए:
https://github.com/flamehaven01/FDS-Dev
ज़रूरी features के सुझाव या issues भी कभी भी स्वागत योग्य हैं!
v0.0.3 वर्ज़न रिलीज़ किया गया है। इस अपडेट का फोकस security और engineering quality को काफ़ी मज़बूत करने पर रहा है.
मुख्य बदलाव इस प्रकार हैं:
सुरक्षा: SECURITY.md, vulnerability report process, साप्ताहिक Dependabot updates, secret scanning, branch protection, security checklist जोड़ी गई
इंजीनियरिंग गुणवत्ता: pre-commit hooks(black/ruff/isort/yamllint/detect-secrets), CI test coverage 70% अनिवार्य, mypy(strict), सभी tool settings को pyproject.toml में एकीकृत किया गया
CI/CD: coverage report, type checking, multi-lint एकीकृत
डॉक्युमेंटेशन: Docker/Kubernetes/monorepo patterns सहित enterprise deployment guide, 10-मिनट tutorial अपडेट
उदाहरण कोड: basic/advanced examples जोड़े गए
पूरे repository का quality score 10% → 72.5% तक सुधरा है।
रिलीज़ नोट्स: https://github.com/flamehaven01/FDS-Dev/releases/tag/v0.0.3
फ़ीडबैक का हमेशा स्वागत है।
MIT लाइसेंस वाला open project है :) ऐसे projects हमेशा स्वागतयोग्य होते हैं।
अच्छा समझने के लिए धन्यवाद! 🙂
इसे MIT लाइसेंस के तहत बनाए रखने का कारण भी यही है कि कोई भी इसे स्वतंत्र रूप से लेकर इस्तेमाल कर सके और अपनी टीम या कंपनी के माहौल के अनुसार आगे विकसित कर सके।
खासकर इस v0.0.3 में हमने security/engineering foundation को काफ़ी मज़बूत किया है, इसलिए
छोटे personal project से लेकर enterprise environment तक आप इसे बिना झिझक उपयोग कर सकेंगे।
अगर इस्तेमाल करते समय आपके पास कोई improvement idea या suggestion हो, तो कभी भी बताइए! 🙌