VPNs מול VPN's: רבים, שייכות ומתי לכתוב את המונח במלואו

רוב הבלבול הוא כלל אחד שהוחל במקום הלא נכון. גרש אינו הופך קיצור לרבים לעולם. שייכות היא משימה אחרת, ויש לה צורה משל עצמה.

שלושה תיקונים פותרים כמעט כל מקרה. חיפוש אחד מאשר את התוצאה, והוא אורך פחות זמן מקריאה חוזרת של הטיוטה.

מעבר ראשון: קודם רבים, אחר כך שייכות

כתבו את הרבים כ-VPNs, בלי גרש ובלי רווח. שלוש מנהרות, שני פרופילים וצי שלם של שערים הם כולם VPNs. אותו כלל חל על קיצורים אחרים, ולכן התבנית נראית מוכרת גם כשהכותב אינו מצליח לנסח אותה.

הגרש שייך לשייכות. VPN's פירושו שייך ל-VPN אחד, כמו השער של מנהרה אחת. שייכות ברבים שמה את הגרש אחרי ה-s, וצורה זו כה נדירה שכתיבה מחדש של המשפט נקראת בדרך כלל טוב יותר.

קראו את המשפט ושאלו מי שייך למה. אם התשובה היא מנהרה אחת, הגרש עושה עבודה. אם התשובה היא מספר, הגרש הוא טעות. הוא גורם לרבים להיראות כמו שייכות, והקורא צריך לעצור ולבדוק.

המחיר של טעות אינו בושה דקדוקית. קורא שרואה VPN's ברשימה של פריטים ספורים צריך להחליט אם התכוונתם למנהרה אחת או לכמה, וההחלטה הזו קוטעת את המשפט.

מעבר שני: הרחיבו פעם אחת, ורק אם הקורא צריך זאת

המונח המלא הוא רשת פרטית וירטואלית, ורבים שלו הוא רשתות פרטיות וירטואליות (VPNs). הרחיבו אותו בשימוש הראשון כשהקהל אולי אינו מכיר את המונח, ואחר כך השתמשו בקיצור לשאר המסמך.

הקהל הוא שמחליט. ההנחיות של Google למפתחים בנושא קיצורים מתייחסות להיכרות כקריטריון ולא כדרישה אוניברסלית, והערת תצורה למהנדסי רשת היא קהל שונה ממדריך למתחילים.

חזרה על ההרחבה בכל סעיף היא הרגל, לא אדיבות. היא מאריכה את הטקסט ומסמנת שהכותב אינו סומך על הפסקה הקודמת.

מעבר שלישי: תנו שם לאובייקט, לא לראשי התיבות

מסמך שאומר שלושה VPNs מתכוון בדרך כלל לאחד משלושה דברים. ייתכן שהוא מתכוון לשלושה פרופילים שמורים במחשב נייד אחד, לשלושה נקודות קצה של שער, או לשלושה חיבורים פעילים. אלה אובייקטים שונים עם שלבי פתרון תקלות שונים, והקיצור מסתיר את ההבדל.

כתבו את האובייקט כשהאובייקט חשוב: פרופילי VPN לתצורות שמורות, שערי VPN לנקודות קצה, חיבורי VPN למנהרות פעילות. הטקסט מתארך במילה אחת ומתקצר באי-הבנה אחת.

# list every mention, with counts, before editing
grep -o -E "VPN'?s?'?|VPN network" article.md | sort | uniq -c

# find the redundant expansion
grep -n -i -E 'virtual private network[s]? \(VPNs?\)' article.md

VPN network שייך לאותו מעבר. ההרחבה כבר מסתיימת במילה רשת, ולכן הביטוי חוזר על המילה שהוא זה עתה פרש. הוא מובן ומיותר, והקורא עשוי לתהות לרגע אם מציין רכיב שני.

קהל מקצועי לא יודה לכם על שפירטתם את המונח בפסקה הרביעית. קהל כללי לא יסלח על היעדרו בפסקה הראשונה. הציבו את ההרחבה פעם אחת, מוקדם, והמשיכו הלאה.

איך נראה התיקון המוגמר

רבים בלי גרש. גרש רק לשייכות. הרחבה אחת, במקום שבו הקורא זקוק לה. שם עצם מדויק בכל מקום שבו הקיצור היה מסתיר לאיזה אובייקט מתכוונים.

אף אחד מהתיקונים האלה אינו משנה עובדה. יחד הם מסירים את שלושת המקומות שבהם קורא זהיר מאט.