Het meeste van de verwarring is één regel die op de verkeerde plek is toegepast. Een apostrof maakt een afkorting nooit meervoudig. Bezit is een andere taak, en die heeft zijn eigen vorm.

Drie correcties lossen bijna elk geval op. Eén zoekopdracht bevestigt het resultaat, en dat kost minder tijd dan het concept opnieuw lezen.

Eerste ronde: eerst het meervoud, dan het bezit

Schrijf het meervoud als VPNs, zonder apostrof en zonder spatie. Drie tunnels, twee profielen en een hele vloot gateways zijn allemaal VPNs. Dezelfde regel geldt voor andere afkortingen, daarom komt het patroon bekend voor, ook als de schrijver het niet kan formuleren.

De apostrof hoort bij het bezit. VPN's betekent toebehoren aan één VPN, zoals de gateway van één tunnel. Een meervoudig bezit zet de apostrof achter de s, en die vorm is zo zeldzaam dat de zin herschrijven meestal prettiger leest.

Lees de zin en vraag wie wat bezit. Is het antwoord één tunnel, dan doet de apostrof werk. Is het antwoord een aantal, dan is de apostrof een fout. Hij laat het meervoud op bezit lijken, en de lezer moet stoppen om het te controleren.

De prijs van een fout is geen grammaticale schaamte. Een lezer die VPN's ziet in een lijst met getelde items, moet beslissen of je één tunnel of meerdere bedoelde, en die beslissing onderbreekt de zin.

Tweede ronde: schrijf één keer uit, en alleen als de lezer het nodig heeft

De volledige term is virtueel particulier netwerk, en het meervoud is virtuele particuliere netwerken (VPNs). Schrijf hem bij het eerste gebruik uit wanneer het publiek de term misschien niet kent, en gebruik daarna de afkorting voor de rest van het document.

Het publiek beslist. De richtlijn van Google voor ontwikkelaars over afkortingen behandelt bekendheid als criterium en niet als universele eis, en een configuratienota voor netwerkingenieurs is een ander publiek dan een gids voor beginners.

De uitschrijving in elke sectie herhalen is een tic, geen beleefdheid. Het maakt de tekst langer en signaleert dat de schrijver de vorige alinea niet vertrouwt.

Derde ronde: benoem het object, niet de afkorting

Een document dat drie VPNs zegt, bedoelt meestal een van drie dingen. Het kan drie opgeslagen profielen op één laptop betekenen, drie gateway-eindpunten of drie actieve verbindingen. Dat zijn verschillende objecten met verschillende stappen voor probleemoplossing, en de afkorting verbergt het verschil.

Schrijf het object wanneer het object ertoe doet: VPN-profielen voor opgeslagen configuraties, VPN-gateways voor eindpunten, VPN-verbindingen voor actieve tunnels. De tekst wordt één woord langer en één misverstand korter.

# 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 hoort bij dezelfde ronde. De uitschrijving eindigt al op netwerk, dus de zin herhaalt het woord dat hij net heeft uitgepakt. Het is begrijpelijk en overbodig, en de lezer kan zich even afvragen of er een tweede component wordt genoemd.

Een gespecialiseerd publiek zal je niet bedanken dat je de term in de vierde alinea hebt uitgeschreven. Een algemeen publiek zal het ontbreken ervan in de eerste alinea niet vergeven. Plaats de uitschrijving één keer, vroeg, en ga verder.

Hoe de voltooide correctie eruitziet

Meervoud zonder apostrof. Apostrof alleen voor bezit. Eén uitschrijving, geplaatst waar de lezer die nodig heeft. Een concreet zelfstandig naamwoord waar de afkorting zou verbergen welk object bedoeld is.

Geen van die correcties verandert een feit. Samen verwijderen ze de drie plekken waar een oplettende lezer langzamer wordt.

Gerelateerde artikelen