Většina zmatku je jedno pravidlo použité na špatném místě. Apostrof nikdy nedělá ze zkratky množné číslo. Přivlastňování je jiná práce a má vlastní podobu.

Tři úpravy opraví téměř každý případ. Jedno hledání výsledek potvrdí a zabere méně času než opětovné čtení konceptu.

První průchod: nejprve množné číslo, pak přivlastňování

Množné číslo pište jako VPNs, bez apostrofu a bez mezery. Tři tunely, dva profily a celá flotila bran jsou všechny VPNs. Stejné pravidlo platí i pro jiné zkratky, a proto vzor působí povědomě, i když ho autor nedokáže pojmenovat.

Apostrof patří přivlastňování. VPN's znamená, že něco patří jednomu VPN, jako brána jediného tunelu. Množné přivlastňování staví apostrof za s a tato podoba je tak vzácná, že přepsání věty se obvykle čte lépe.

Přečtěte větu a zeptejte se, komu co patří. Je-li odpovědí jediný tunel, apostrof dělá práci. Je-li odpovědí počet, apostrof je chyba. Dělá z množného čísla přivlastňování a čtenář se musí zastavit a ověřit.

Cena chyby není gramatická ostuda. Čtenář, který vidí VPN's v seznamu počítaných položek, musí rozhodnout, zda jste mysleli jeden tunel, nebo několik, a to rozhodnutí přerušuje větu.

Druhý průchod: rozepište jednou, a jen když to čtenář potřebuje

Úplný pojem je virtuální privátní síť a jeho množné číslo virtuální privátní sítě (VPNs). Rozepište ho při prvním použití, když publikum pojem možná nezná, a zbytek dokumentu používejte zkratku.

Rozhoduje publikum. Pokyny Google pro vývojáře ke zkratkám berou obeznámenost jako kritérium, nikoli jako univerzální požadavek, a konfigurační poznámka pro síťové inženýry má jiné publikum než příručka pro začátečníky.

Opakovat rozepsání v každé sekci je zlozvyk, ne zdvořilost. Prodlužuje text a naznačuje, že autor nedůvěřuje předchozímu odstavci.

Třetí průchod: pojmenujte objekt, ne zkratku

Dokument, který říká tři VPNs, obvykle míní jedno ze tří. Může jít o tři uložené profily na jednom notebooku, tři koncové body brány nebo tři aktivní připojení. To jsou různé objekty s různými postupy řešení problémů a zkratka rozdíl skrývá.

Pište objekt, když na objektu záleží: profily VPN pro uložené konfigurace, brány VPN pro koncové body, připojení VPN pro živé tunely. Text je o slovo delší a o jedno nedorozumění kratší.

# 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 patří do stejného průchodu. Rozepsání už končí slovem síť, takže fráze opakuje slovo, které právě rozbalila. Je srozumitelná a je zbytečná a čtenář se může na chvíli ptát, zda se nejmenuje druhý komponent.

Odborné publikum vám nepoděkuje za to, že jste pojem rozepsali ve čtvrtém odstavci. Obecné publikum neodpustí jeho nepřítomnost v odstavci prvním. Umístěte rozepsání jednou, brzy, a jděte dál.

Jak vypadá hotová úprava

Množné číslo bez apostrofu. Apostrof jen pro přivlastňování. Jedno rozepsání tam, kde ho čtenář potřebuje. Konkrétní podstatné jméno tam, kde by zkratka skryla, který objekt je míněn.

Žádná z těchto úprav nemění fakt. Dohromady odstraňují tři místa, kde se pozorný čtenář zdržuje.

Související články