VPNs vs VPN's: meervoud, besitting en wanneer om die volle term te spel
'n Apostroof maak nie 'n afkorting meervoudig nie. Regstel die meervoud, die besitting en die oorbodige uitbreiding, en noem dan die voorwerp wat jy werklik bedoel.
Die meeste verwarring kom van een reël wat op die verkeerde plek toegepas word. 'n Apostroof maak nooit 'n afkorting meervoudig nie. Besitting is 'n ander taak, en dit het sy eie vorm.
Drie wysigings regstel byna elke geval. Een soektog bevestig die resultaat, en dit neem minder tyd as om die konsep weer te lees.
Eerste deurloop: meervoud, dan besitting
Skryf die meervoud as VPNs, sonder apostroof en sonder spasie. Drie tonnels, twee profiele en 'n vloot poorte is almal VPNs. Dieselfde reël geld vir ander afkortings, en daarom lyk die patroon bekend selfs wanneer die skrywer dit nie kan verwoord nie.
Besitting is waar die apostroof hoort. VPN's beteken wat aan een VPN behoort, soos die poort van 'n enkele tonnel. 'n Meervoudige besitting plaas die apostroof ná die s, en daardie vorm is so skaars dat 'n herskrywing van die sin gewoonlik beter lees.
Lees die sin en vra wie wat besit. As die antwoord 'n enkele tonnel is, doen die apostroof werk. As die antwoord 'n aantal is, is die apostroof 'n fout. Dit laat die meervoud soos 'n besitting lyk, en die leser moet stop en kyk.
Die koste van 'n fout is nie grammatikale skaamte nie. 'n Leser wat VPN's in 'n lys getelde items sien, moet besluit of jy een tonnel of verskeie bedoel het, en daardie besluit onderbreek die sin.
Tweede deurloop: brei een keer uit, en net as die leser dit nodig het
Die volle term is virtuele private netwerk, en die meervoud daarvan is virtuele private netwerke (VPNs). Brei by die eerste gebruik uit wanneer die gehoor die term dalk nie ken nie, en gebruik daarna die afkorting vir die res van die dokument.
Die gehoor besluit. Die Google-ontwikkelaarsdokumentasie se riglyne oor afkortings behandel vertroudheid as die maatstaf eerder as 'n universele vereiste, en 'n konfigurasienota vir netwerkingenieurs is 'n ander gehoor as 'n beginnersgids.
'n Herhaling van die uitbreiding in elke afdeling is 'n gewoonte, nie 'n hoflikheid nie. Dit maak die teks langer en wys dat die skrywer nie die vorige paragraaf vertrou nie.
Derde deurloop: noem die voorwerp, nie die afkorting nie
'n Dokument wat drie VPNs noem, bedoel gewoonlik een van drie dinge. Dit kan drie gestoorde profiele op een skootrekenaar beteken, drie poort-eindpunte, of drie aktiewe verbindings. Dit is verskillende voorwerpe met verskillende foutsporingsstappe, en die afkorting verberg die verskil.
Skryf die voorwerp wanneer die voorwerp saak maak: VPN-profiele vir gestoorde konfigurasies, VPN-poorte vir eindpunte, VPN-verbindings vir lewendige tonnels. Die teks word een woord langer en een 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 in dieselfde deurloop. Die uitbreiding eindig reeds op netwerk, so die frase herhaal die woord wat dit pas uitgespel het. Dit is verstaanbaar en dit is onnodig, en 'n leser wonder dalk kortliks of 'n tweede komponent genoem word.
'n Spesialistegehoor sal jou nie bedank omdat jy die term in paragraaf vier uitspel nie. 'n Algemene gehoor sal die afwesigheid daarvan in paragraaf een nie vergewe nie. Plaas die uitbreiding een keer, vroeg, en gaan aan.
Hoe die voltooide wysiging lyk
Meervoud sonder 'n apostroof. Apostroof net vir besitting. Een uitbreiding, geplaas waar die leser dit nodig het. 'n Spesifieke selfstandige naamwoord waar die afkorting sou verberg watter voorwerp bedoel word.
Nie een van daardie wysigings verander 'n feit nie. Saam verwyder hulle die drie plekke waar 'n noukeurige leser stadiger lees.