Większość zamieszania to jedna zasada zastosowana w niewłaściwym miejscu. Apostrof nigdy nie czyni skrótu liczbą mnogą. Dzierżawczość to inne zadanie i ma własną formę.

Trzy poprawki rozwiązują niemal każdy przypadek. Jedno wyszukiwanie potwierdza wynik i zajmuje mniej czasu niż ponowne czytanie szkicu.

Pierwsze przejście: najpierw liczba mnoga, potem dzierżawczość

Zapisuj liczbę mnogą jako VPNs, bez apostrofu i bez spacji. Trzy tunele, dwa profile i cała flota bram to wszystko VPNs. Ta sama zasada dotyczy innych skrótów, dlatego wzorzec wydaje się znajomy, nawet gdy autor nie potrafi go sformułować.

Apostrof należy do formy dzierżawczej. VPN's oznacza przynależność do jednego VPN, jak brama jednego tunelu. Dzierżawczość w liczbie mnogiej stawia apostrof po s, a ta forma jest tak rzadka, że przepisanie zdania czyta się zwykle lepiej.

Przeczytaj zdanie i zapytaj, kto co posiada. Jeśli odpowiedzią jest jeden tunel, apostrof wykonuje pracę. Jeśli odpowiedzią jest liczba, apostrof jest błędem. Sprawia, że liczba mnoga wygląda jak dzierżawczość, a czytelnik musi się zatrzymać i sprawdzić.

Koszt błędu to nie gramatyczny wstyd. Czytelnik, który widzi VPN's na liście policzonych elementów, musi zdecydować, czy chodziło o jeden tunel, czy o kilka, i ta decyzja przerywa zdanie.

Drugie przejście: rozwiń raz i tylko wtedy, gdy czytelnik tego potrzebuje

Pełny termin to wirtualna sieć prywatna, a jego liczba mnoga to wirtualne sieci prywatne (VPNs). Rozwiń go przy pierwszym użyciu, gdy odbiorcy mogą nie znać terminu, a potem używaj skrótu w dalszej części dokumentu.

Decyduje odbiorca. Wytyczne Google dla programistów dotyczące skrótów traktują znajomość jako kryterium, a nie jako uniwersalny wymóg, a notatka konfiguracyjna dla inżynierów sieci ma innego odbiorcę niż poradnik dla początkujących.

Powtarzanie rozwinięcia w każdej sekcji to nawyk, nie uprzejmość. Wydłuża tekst i sygnalizuje, że autor nie ufa poprzedniemu akapitowi.

Trzecie przejście: nazwij obiekt, nie skrót

Dokument, który mówi trzy VPNs, zwykle ma na myśli jedną z trzech rzeczy. Może chodzić o trzy zapisane profile na jednym laptopie, trzy punkty końcowe bramy albo trzy aktywne połączenia. To różne obiekty o różnych krokach rozwiązywania problemów, a skrót ukrywa różnicę.

Pisz obiekt, gdy obiekt ma znaczenie: profile VPN dla zapisanych konfiguracji, bramy VPN dla punktów końcowych, połączenia VPN dla aktywnych tuneli. Tekst staje się o jedno słowo dłuższy i o jedno nieporozumienie krótszy.

# 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 należy do tego samego przejścia. Rozwinięcie kończy się już na sieć, więc fraza powtarza słowo, które właśnie rozwinęła. Jest zrozumiała i zbędna, a czytelnik może się przez chwilę zastanawiać, czy nie nazywa się drugiego komponentu.

Odbiorca specjalistyczny nie podziękuje za rozwinięcie terminu w czwartym akapicie. Odbiorca ogólny nie wybaczy jego braku w pierwszym akapicie. Umieść rozwinięcie raz, wcześnie, i idź dalej.

Jak wygląda gotowa poprawka

Liczba mnoga bez apostrofu. Apostrof tylko dla formy dzierżawczej. Jedno rozwinięcie, umieszczone tam, gdzie czytelnik go potrzebuje. Konkretny rzeczownik tam, gdzie skrót ukryłby, o który obiekt chodzi.

Żadna z tych poprawek nie zmienia faktu. Razem usuwają trzy miejsca, w których uważny czytelnik zwalnia.

Powiązane artykuły