Det meste av forvirringen er én regel brukt på feil sted. En apostrof gjør aldri en forkortelse til flertall. Eiendomsform er en annen oppgave, og den har sin egen form.

Tre rettelser ordner nesten hvert tilfelle. Ett søk bekrefter resultatet, og det tar kortere tid enn å lese utkastet på nytt.

Første gjennomgang: flertall først, deretter eiendomsform

Skriv flertallet som VPNs, uten apostrof og uten mellomrom. Tre tunneler, to profiler og en hel flåte av gatewayer er alle VPNs. Den samme regelen gjelder andre forkortelser, og derfor virker mønsteret kjent selv når forfatteren ikke kan formulere det.

Apostrofen hører til eiendomsformen. VPN's betyr å tilhøre én VPN, som gatewayen til én tunnel. Flertalls-eiendomsform setter apostrofen etter s, og den formen er så sjelden at en omskriving av setningen som regel leses bedre.

Les setningen og spør hvem som eier hva. Er svaret én tunnel, gjør apostrofen arbeid. Er svaret et antall, er apostrofen en feil. Den får flertallet til å se ut som eiendomsform, og leseren må stoppe og kontrollere.

Prisen for å ta feil er ikke grammatisk skam. En leser som ser VPN's i en liste med talte elementer, må avgjøre om du mente én tunnel eller flere, og den avgjørelsen avbryter setningen.

Andre gjennomgang: skriv ut én gang, og bare hvis leseren trenger det

Det fulle begrepet er virtuelt privat nettverk, og flertallet er virtuelle private nettverk (VPNs). Skriv det ut ved første bruk når leserne kanskje ikke kjenner begrepet, og bruk deretter forkortelsen resten av dokumentet.

Leserne avgjør. Googles veiledning for utviklere om forkortelser behandler kjennskap som et kriterium og ikke som et generelt krav, og et konfigurasjonsnotat for nettingeniører har en annen lesergruppe enn en nybegynnerguide.

Å gjenta utskrivingen i hver seksjon er en vane, ikke en høflighet. Det gjør teksten lengre og signaliserer at forfatteren ikke stoler på forrige avsnitt.

Tredje gjennomgang: navngi objektet, ikke forkortelsen

Et dokument som sier tre VPNs, mener som regel én av tre ting. Det kan bety tre lagrede profiler på én bærbar datamaskin, tre gateway-endepunkter eller tre aktive tilkoblinger. Det er forskjellige objekter med forskjellige feilsøkingstrinn, og forkortelsen skjuler forskjellen.

Skriv objektet når objektet betyr noe: VPN-profiler for lagrede konfigurasjoner, VPN-gatewayer for endepunkter, VPN-tilkoblinger for aktive tunneler. Teksten blir ett ord lengre og én misforståelse kortere.

# 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 hører til samme gjennomgang. Utskrivingen ender allerede på nettverk, så frasen gjentar ordet den nettopp pakket ut. Den er forståelig og unødvendig, og leseren kan et øyeblikk lure på om en annen komponent blir navngitt.

Et spesialisert publikum vil ikke takke deg for å skrive ut begrepet i fjerde avsnitt. Et allment publikum vil ikke tilgi at det mangler i første avsnitt. Plasser utskrivingen én gang, tidlig, og gå videre.

Slik ser den ferdige rettelsen ut

Flertall uten apostrof. Apostrof bare for eiendomsform. Én utskriving, plassert der leseren trenger den. Et konkret substantiv der forkortelsen ville skjule hvilket objekt som menes.

Ingen av disse rettelsene endrer et faktum. Sammen fjerner de de tre stedene der en oppmerksom leser senker tempoet.

Relaterte artikler