הערות קוד ומחרוזות תיעוד (Docstrings): כיצד לתרגם רק הערות מבלי לשנות את הקוד?
אבחון מצב עכשווי מרכזי
“כאשר מכניסים קובץ מקור למתרגם, לעיתים גם שמות משתנים ומילות מפתח לוגיות (if/for) מתורגמים, מה שעלול לגרום להשחתת הקוד.”
ניתוח סיבת השורש
1
זיהוי ברמת AST (עץ תחביר מופשט)
商译 AI אינו מבצע רק התאמות רגולריות, אלא גם ניתוח תחבירי קל. ב-Python, הוא מזהה במדויק Docstrings שמוקפים ב-`'''...'''`; עבור Java/JS, המערכת מזהה בלוקים מסוג `/**...*/`.
2
שמירת הוראות
בתוך בלוקי הערות, עבור הוראות כמו `@param`, `@return`, `@author` ואחרות, המערכת שומרת את כותרת ההוראה ומתרגמת רק את הטקסט התיאורי שמופיע לאחריה, כדי להבטיח שתיעוד ה-API (כגון Javadoc, Sphinx) יישמר בפורמט תקין.
סיכום הפתרון הסופי
מסייע ביצירת תיעוד רב-לשוני באופן מהיר לפרויקטי קוד פתוח, ומפחית את סף הכניסה לתרומה של מפתחים מכל העולם.