A zavar nagy része egyetlen szabály helytelen helyen való alkalmazása. Az aposztróf soha nem tesz egy rövidítést többes számúvá. A birtoklás más feladat, és megvan a maga formája.

Három javítás szinte minden esetet megold. Egyetlen keresés megerősíti az eredményt, és kevesebb időt vesz igénybe, mint a piszkozat újraolvasása.

Első kör: előbb a többes szám, aztán a birtokos

Írd a többes számot VPNs alakban, aposztróf és szóköz nélkül. Három alagút, két profil és egy egész flotta átjáró mind VPNs. Ugyanez a szabály vonatkozik más rövidítésekre is, ezért tűnik ismerősnek a minta akkor is, amikor a szerző nem tudja megfogalmazni.

Az aposztróf a birtokláshoz tartozik. A VPN's azt jelenti, hogy egy VPN-hez tartozik, mint egyetlen alagút átjárója. A többes birtokos az aposztrófot az s után teszi, és ez a forma olyan ritka, hogy a mondat átfogalmazása általában jobban olvasható.

Olvasd el a mondatot, és kérdezd meg, kié mi. Ha a válasz egyetlen alagút, az aposztróf munkát végez. Ha a válasz egy szám, az aposztróf hiba. Birtoklásnak láttatja a többes számot, és az olvasónak meg kell állnia ellenőrizni.

A hiba ára nem nyelvtani szégyen. Az olvasónak, aki VPN's lát a megszámlált elemek listáján, el kell döntenie, hogy egy alagútra vagy többre gondoltál, és ez a döntés megszakítja a mondatot.

Második kör: egyszer fejtsd ki, és csak ha az olvasónak szüksége van rá

A teljes kifejezés a virtuális magánhálózat, többes száma pedig a virtuális magánhálózatok (VPNs). Az első használatkor fejtsd ki, ha a közönség esetleg nem ismeri a kifejezést, utána pedig használd a rövidítést a dokumentum végéig.

A közönség dönt. A Google fejlesztői útmutatója a rövidítésekről az ismertséget tekinti kritériumnak, nem általános követelménynek, és a hálózati mérnököknek szóló konfigurációs jegyzet más közönség, mint egy kezdőknek szóló útmutató.

A kifejtés megismétlése minden szakaszban szokás, nem udvariasság. Megnyújtja a szöveget, és azt jelzi, hogy a szerző nem bízik az előző bekezdésben.

Harmadik kör: a tárgyat nevezd meg, ne a rövidítést

Egy dokumentum, amely három VPNs-t említ, általában három dolog egyikére gondol. Jelenthet három mentett profilt egy laptopon, három átjáró-végpontot vagy három aktív kapcsolatot. Ezek különböző tárgyak különböző hibaelhárítási lépésekkel, és a rövidítés elrejti a különbséget.

Írd ki a tárgyat, amikor a tárgy számít: VPN-profilok a mentett konfigurációkhoz, VPN-átjárók a végpontokhoz, VPN-kapcsolatok az aktív alagutakhoz. A szöveg egy szóval hosszabb és egy félreértéssel rövidebb lesz.

# 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

A VPN network ugyanahhoz a körhöz tartozik. A kifejtés már hálózat szóval végződik, tehát a kifejezés megismétli azt a szót, amelyet épp most bontott ki. Érthető és fölösleges, és az olvasó egy pillanatra eltűnődhet, hogy egy második összetevőt neveznek-e meg.

Egy szakmai közönség nem fog megköszönni, hogy a negyedik bekezdésben kifejtetted a kifejezést. Egy általános közönség nem fogja megbocsátani a hiányát az első bekezdésben. Helyezd el a kifejtést egyszer, korán, és lépj tovább.

Hogyan néz ki a kész javítás

Többes szám aposztróf nélkül. Aposztróf csak a birtokláshoz. Egyetlen kifejtés ott, ahol az olvasónak szüksége van rá. Pontos főnév mindenhol, ahol a rövidítés elrejtené, melyik tárgyra gondolunk.

Ezek közül egyik javítás sem változtat tényt. Együtt eltávolítják azt a három helyet, ahol a figyelmes olvasó lelassul.

Kapcsolódó cikkek