Det mesta av förvirringen är en regel som tillämpats på fel ställe. En apostrof gör aldrig en förkortning plural. Genitiv är en annan uppgift, och den har sin egen form.

Tre rättelser löser nästan varje fall. En enda sökning bekräftar resultatet, och det tar kortare tid än att läsa utkastet igen.

Första genomgången: först plural, sedan genitiv

Skriv pluralen som VPNs, utan apostrof och utan mellanslag. Tre tunnlar, två profiler och en hel flotta av gateways är alla VPNs. Samma regel gäller andra förkortningar, därför verkar mönstret bekant även när skribenten inte kan formulera det.

Apostrofen hör till genitiven. VPN's betyder att tillhöra en VPN, som gatewayen för en enda tunnel. Plural genitiv sätter apostrofen efter s, och den formen är så ovanlig att en omskrivning av meningen oftast läses bättre.

Läs meningen och fråga vem som äger vad. Är svaret en enda tunnel gör apostrofen arbete. Är svaret ett antal är apostrofen ett fel. Den får pluralen att se ut som genitiv, och läsaren måste stanna och kontrollera.

Priset för att ha fel är inte grammatisk skam. En läsare som ser VPN's i en lista med räknade objekt måste avgöra om du menade en tunnel eller flera, och det beslutet avbryter meningen.

Andra genomgången: skriv ut en gång, och bara om läsaren behöver det

Den fullständiga termen är virtuellt privat nätverk, och pluralen är virtuella privata nätverk (VPNs). Skriv ut den vid första användningen när läsarna kanske inte känner till termen, och använd sedan förkortningen resten av dokumentet.

Läsarna avgör. Googles riktlinjer för utvecklare om förkortningar behandlar bekantskap som ett kriterium och inte som ett generellt krav, och en konfigurationsanteckning för nätverkstekniker har en annan läsekrets än en nybörjarguide.

Att upprepa utskrivningen i varje avsnitt är en ovana, inte en artighet. Det gör texten längre och signalerar att skribenten inte litar på föregående stycke.

Tredje genomgången: namnge objektet, inte förkortningen

Ett dokument som säger tre VPNs menar oftast en av tre saker. Det kan betyda tre sparade profiler på en laptop, tre gateway-slutpunkter eller tre aktiva anslutningar. Det är olika objekt med olika felsökningssteg, och förkortningen döljer skillnaden.

Skriv objektet när objektet spelar roll: VPN-profiler för sparade konfigurationer, VPN-gateways för slutpunkter, VPN-anslutningar för aktiva tunnlar. Texten blir ett ord längre och en missuppfattning kortare.

# 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ör till samma genomgång. Utskrivningen slutar redan på nätverk, så frasen upprepar ordet den just packade upp. Den är begriplig och onödig, och läsaren kan ett ögonblick undra om en andra komponent nämns.

En specialiserad läsekrets tackar dig inte för att du skrev ut termen i fjärde stycket. En allmän läsekrets förlåter inte att den saknas i första stycket. Placera utskrivningen en gång, tidigt, och gå vidare.

Så ser den färdiga rättelsen ut

Plural utan apostrof. Apostrof bara för genitiv. En utskrivning, placerad där läsaren behöver den. Ett konkret substantiv där förkortningen skulle dölja vilket objekt som avses.

Ingen av dessa rättelser ändrar ett faktum. Tillsammans tar de bort de tre ställen där en uppmärksam läsare saktar ner.

Relaterade artiklar