VPNs vs VPN's: množina, svojilnost in kdaj razviti izraz
Apostrof iz okrajšave ne naredi množine. Popravite množino, svojilnost in odvečno razvijanje, nato poimenujte predmet, ki ga res mislite.
Večina zmede je eno pravilo, uporabljeno na napačnem mestu. Apostrof nikoli ne naredi iz okrajšave množine. Svojilnost je drugo delo in ima svojo obliko.
Trije popravki rešijo skoraj vsak primer. Eno iskanje potrdi rezultat in traja manj časa kot ponovno branje osnutka.
Prvi prehod: najprej množina, nato svojilnost
Množino pišite kot VPNs, brez apostrofa in brez presledka. Trije predori, dva profila in cela flota prehodov so vsi VPNs. Isto pravilo velja tudi za druge okrajšave, zato se vzorec zdi znan tudi takrat, ko ga avtor ne zna oblikovati.
Apostrof pripada svojilnosti. VPN's pomeni, da pripada enemu VPN, kot prehod enega predora. Množinska svojilnost postavi apostrof za s in ta oblika je tako redka, da se prepisani stavek običajno bere bolje.
Preberite stavek in vprašajte, kdo kaj ima. Če je odgovor en predor, apostrof opravlja delo. Če je odgovor število, je apostrof napaka. Množino naredi podobno svojilnosti in bralec se mora ustaviti ter preveriti.
Cena napake ni slovnična sramota. Bralec, ki v seznamu preštetih elementov vidi VPN's, mora odločiti, ali ste mislili en predor ali več, in ta odločitev prekine stavek.
Drugi prehod: razvijte enkrat in samo če bralec to potrebuje
Polni izraz je virtualno zasebno omrežje, njegova množina pa virtualna zasebna omrežja (VPNs). Razvijte ga ob prvi uporabi, ko publika izraza morda ne pozna, nato pa v preostalem dokumentu uporabljajte okrajšavo.
Odloča publika. Googlove smernice za razvijalce o okrajšavah obravnavajo poznavanje kot merilo in ne kot splošno zahtevo, konfiguracijska opomba za omrežne inženirje pa ima drugo publiko kot vodnik za začetnike.
Ponavljanje razvijanja v vsakem razdelku je navada, ne vljudnost. Besedilo podaljša in pokaže, da avtor ne zaupa prejšnjemu odstavku.
Tretji prehod: poimenujte predmet, ne okrajšave
Dokument, ki reče tri VPNs, običajno misli eno od treh stvari. To so lahko trije shranjeni profili na enem prenosniku, tri končne točke prehoda ali tri aktivne povezave. To so različni predmeti z različnimi koraki za odpravljanje težav, okrajšava pa razliko skrije.
Pišite predmet, ko je predmet pomemben: profili VPN za shranjene konfiguracije, prehodi VPN za končne točke, povezave VPN za aktivne predore. Besedilo postane za eno besedo daljše in za en nesporazum krajše.
# 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 spada v isti prehod. Razvijanje se že konča z omrežje, zato fraza ponovi besedo, ki jo je pravkar razvila. Je razumljiva in odveč, bralec pa se lahko za trenutek vpraša, ali se poimenuje druga komponenta.
Strokovna publika vam ne bo hvaležna, ker ste izraz razvili v četrtem odstavku. Splošna publika ne bo odpustila njegove odsotnosti v prvem odstavku. Razvijanje postavite enkrat, zgodaj, in pojdite naprej.
Kako je videti končani popravek
Množina brez apostrofa. Apostrof samo za svojilnost. Eno razvijanje, postavljeno tja, kjer ga bralec potrebuje. Konkreten samostalnik tam, kjer bi okrajšava skrila, kateri predmet je mišljen.
Noben od teh popravkov ne spremeni dejstva. Skupaj odstranijo tri mesta, kjer se pozoren bralec upočasni.