Grammatika és mechanika

Bizonyos nyelvtani és mechanikai szabályok betartása segít abban, hogy írásunk világos és következetes legyen. Ez a szakasz a házi stílusunkat határozza meg, amely minden tartalmunkra vonatkozik, hacsak az útmutató másként nem rendelkezik. (Ebben a részben sok mindenre kitérünk – a keresési funkció segít, ha valamit konkrétan keres.)

Az alapok

Az írás minden olvasónak szól. Vannak, akik minden egyes szót elolvasnak, amit írsz. Mások csak átfutják. Segítsen mindenkinek jobban olvasni azzal, hogy az összefüggő gondolatokat csoportosítja, és leíró fejléceket és alcímeket használ.

Fókuszálja az üzenetét. Hozzon létre egy információs hierarchiát. Vezessen a főponttal vagy a legfontosabb tartalommal, mondatokban, bekezdésekben, szakaszokban és oldalakonként.

Legyen tömör. Használjon rövid szavakat és mondatokat. Kerülje a felesleges módosítókat.

Legyen konkrét. Kerülje a homályos megfogalmazásokat. Hagyja ki a mellébeszélést.

Legyen következetes. Tartsa be az ebben az útmutatóban ismertetett szövegmintákat és stíluspontokat.

Útmutató

Rövidítések és rövidítések

Ha van rá esély, hogy az olvasó nem ismer fel egy rövidítést vagy rövidítést, írja ki, amikor először említi. Ezután minden további hivatkozásnál a rövidített változatot használja. Ha a rövidítés nem kapcsolódik egyértelműen a teljes változathoz, adja meg zárójelben.

• Első használat: Hálózati üzemeltetési központ
• Második használat: NOC
• Első használat: Koordinált világidő (UTC)
• Második használat:

Ha a rövidítés vagy rövidítés jól ismert, mint például az API vagy a HTML, használd helyette (és ne törődj a helyesírással).

aktív hang

Az aktív hangot használd. Kerülje a passzív hangot.

Az aktív hangban a mondat alanya végzi a cselekvést. Passzív hangnemben a mondat alanyával végzi el a cselekvést.

• Igen: Marti bejelentkezett a fiókba.
• Nem: A fiókba Marti jelentkezett be.

Az olyan szavak, mint “volt” és “által” jelezhetik, hogy passzív hangnemben írsz. Keresse ezeket a szavakat, és dolgozza át azokat a mondatokat, amelyekben előfordulnak.

Az egyik kivétel az, amikor kifejezetten a cselekvést akarja hangsúlyozni az alannyal szemben. Bizonyos esetekben ez rendben van.

• Az Ön fiókját a visszaélésekkel foglalkozó csapatunk megjelölte.

Kapitalizáció

A kapitalizációnak többféle formáját használjuk. A címszó nagybetűvel írja minden szó első betűjét, kivéve a cikkeket, a prepozíciókat és a kötőszavakat. A mondat nagybetűs írásmódja az első szó első betűjét írja nagybetűvel.

Az e-mail cím vagy a weboldal URL-címének kiírásakor használjon csupa kisbetűt.

• [email protected]
• mailchimp.com

Ne írjon nagybetűvel véletlenszerű szavakat a mondatok közepén. Íme néhány szó, amelyet soha nem írunk nagybetűvel egy mondatban. Továbbiakért lásd a szólistát.

• website
• internet
• online
• email

Szerződések

Nagyszerűek! Nem hivatalos, barátságos hangnemet kölcsönöznek az írásodnak.

Emoji

Az emoji szórakoztató módja annak, hogy humort és vizuális érdekességet adj az írásodhoz, de használd őket ritkán és megfontoltan.

Számok

A számot írd ki, ha egy mondat elején van. Egyébként használd a számjegyet. Ez a rendszámokat is magában foglalja.

• Tíz új alkalmazott kezdett hétfőn, és 12 a jövő héten.
• Három fánkot ettem a Coffee Hourban.
• Meg nyerte az első helyet a tavalyi Walktober versenyen.
• Egy nyolcadikosokból álló csoportot láttunk vendégül, akik kódolni tanulnak.

Néha furcsa érzés a számjegyet használni. Ha olyan kifejezésről van szó, amely jellemzően kiírt számjegyeket használ, hagyja így.

• A barátságos üdvözlő e-mail segíthet az első benyomás kialakításában.
• Ez egy harmadik féltől származó integráció.
• Tegye a legjobb formáját a minden egyben marketingplatformmal, amely együtt növekszik Önnel.
• A hírlevél elküldése után Freddie ad egy pacsit.

A 3 számjegy feletti számok vesszőt kapnak:

• 999
• 1,000
• 150,000

A nagy számokat teljes egészében írja ki. Rövidítsd le őket, ha helyszűke van, például egy tweetben vagy egy táblázatban:

Dátumok

Általában írja ki a hét napját és a hónapot. Csak akkor rövidítsd le, ha az alkalmazásban helyhiány van.

• Szombat, január 24
• Szombat.., Január 24

Tizedesjegyek és törtek

Írd ki a törteket.

• Igen: kétharmad
• Nem: 2/3

Használj tizedesjegyeket, ha egy szám nem írható ki könnyen törtként, például 1,375 vagy 47,2.

Százalékok

A “százalék” kiírása helyett használd a % szimbólumot.

Tartományok és tartományok

A számok tartományának vagy tartományának jelölésére használj kötőjelet (-).

• Ez 20-30 napot vesz igénybe.

Pénz

Amikor az amerikai pénznemről írunk, használjuk a dollárjelet az összeg előtt. Tizedesjegyet és a centek számát is tüntesse fel, ha több mint 0.

• $20
• $19.99

Amikor más pénznemekről ír, kövesse ugyanazt a szimbólum-összeg formátumot:

• ¥1
• €1

Telefonszámok

A számok között használjon kötőjelet szóköz nélkül. Használjon országkódot, ha az olvasója más országban van.

• 555-867-5309
• +1-404-123-4567

Hőmérséklet

Használja a fokjelet és a nagy F rövidítést Fahrenheitre.

• 98°F

Az idő

A számjegyeket és az am vagy pm számot használja, a kettő között szóközzel. Ne használjon perceket az óránkénti időhöz.

• 7 óra reggel
• 7:30 este

Az időpontok között használjon kötőjelet, hogy jelezze az időtartamot.

• 7 am-10:30 pm

Meghatározza az időzónákat, ha egy eseményről vagy valami másról ír, amit az embereknek be kellene ütemezniük. Mivel a Mailchimp Atlantában van, alapértelmezés szerint ET-t használunk.

Az Egyesült Államok kontinentális részén belüli időzónákat a következőképpen rövidítsük le:

• Keleti idő: ET
• Központi idő: CT
• Hegyvidéki idő: MT
• Csendes-óceáni idő: PT

A nemzetközi időzónákra való hivatkozáskor írja ki őket: Nepáli standard idő, Ausztrál keleti idő. Ha egy időzónának nincs meghatározott neve, használja a koordinált világidő (UTC) eltolását.

Az elmúlt 100 évben eltelt évtizedekre való hivatkozáskor rövidítse az évtizedeket.

• a 00-as évek
• a 90-es évek

A 100 évnél régebben eltelt évtizedekre való hivatkozáskor legyen pontosabb:

• az 1900-as évek
• az 1890-es évek

Aposztrófok

Aposztrófok

Aposztróf leggyakoribb használata, hogy egy szót birtokossá tesz. Ha a szó már s-re végződik, és egyes számban van, akkor is hozzáadunk egy ‘s’-t. Ha a szó s-re végződik és többes számban van, csak egy aposztrófot teszünk hozzá.

• A fánktolvaj megette Sam fánkját.
• A fánktolvaj megette Chris fánkját.
• A fánktolvaj megette a vezetők fánkjait.

Aposztrófokat használhatunk annak jelölésére is, hogy néhány betűt kihagytunk egy szóból, általában humor vagy hangsúlyozás céljából. Ez rendben van, de csak takarékosan használd.

Kettőspont

Kettőspontot használj (ellipszis, em-jel vagy vessző helyett) egy felsorolás eltolásához.

• Erin 3 féle fánkot rendelt: mázas, csokoládés és tökfánkot.

Kettőspontot használhatsz két összefüggő kifejezés összekapcsolására is. Ha a kettőspont után egy teljes mondat következik, az 1. szót írja nagybetűvel.

• Dilemma előtt álltam: fánkot akartam, de épp most ettem egy bagelt.

Kommák

A felsorolás írásakor használja a sorvégi vesszőt (más néven oxfordi vessző).

• Igen: David csodálja a szüleit, Oprah-t és Justin Timberlake-et.
• Nem: David csodálja a szüleit, Oprah-t és Justin Timberlake-et.

Minden más esetben használd a józan észt. Ha bizonytalan vagy, olvasd fel hangosan a mondatot. Ahol szünetet tart, használjon vesszőt.

Keresztjelek és kötőjelek

A kötőjelet (-) szóközök nélkül használja mindkét oldalon, hogy szavakat egyetlen mondatrészbe kapcsoljon, vagy hogy terjedelmet vagy tartományt jelöljön.

• első felhasználó
• Hétfőtől péntekig

Em kötőjelet (-) használjon szóközök nélkül mindkét oldalon, hogy eltoljon egy félközt.

Valódi em kötőjelet használjon, ne kötőjelet (- vagy –).

• A többváltozós tesztelés – csak egy az új Pro funkcióink közül – segíthet vállalkozásának növekedésében.
• Austin azt hitte, hogy Brad a fánktolvaj, de tévedett – Lain volt az.

Ellipszisek

Az ellipszisek (…) jelezhetik, hogy egy gondolat vége előtt elmarad. Használd őket takarékosan. Ne használja őket hangsúlyozásra vagy drámaiságra, és ne használja őket címekben vagy fejlécekben.

• “Hová tűnt az a sok fánk?” Christy megkérdezte. Lain azt mondta: “Nem tudom…”

A zárójelben lévő ellipsziseket arra is használhatod, hogy jelezd, hogy kihagysz szavakat egy idézetben.

• “Amikor az emberi események menetében szükségessé válik, hogy az egyik nép feloldja a politikai köteléket, amely egy másikhoz kötötte, és a földi hatalmak közé lépjen, az emberiség véleménye iránti tisztességes tisztelet megköveteli, hogy kinyilvánítsa az okokat, amelyek a szétválásra késztetik.”

Periódusok

A periódusok idézőjelek közé kerülnek. Zárójelen kívülre kerülnek, ha a zárójel egy nagyobb mondat része, és zárójelen belülre, ha a zárójel önmagában áll.

• Christy azt mondta: “Ettem egy fánkot.”
• Ettem egy fánkot (és ettem egy kiflit is).
• Ettem egy fánkot és egy kiflit. (A fánk Samé volt.)

A mondatok között hagyj egy szóközt.

Kérdőjelek

A kérdőjelek idézőjelek közé kerülnek, ha az idézet részét képezik. A pontokhoz hasonlóan a zárójeleken kívülre kerülnek, ha a zárójel egy nagyobb mondat része, és zárójelek közé, ha a zárójel önmagában áll.

Kiáltójelek

A felkiáltójeleket takarékosan használja, és soha ne használjon egyszerre egynél többet. Olyanok, mint a pacsi: Egy jól időzített nagyszerű, de a túl sok bosszantó lehet.

A felkiáltójelek idézőjelek közé tartoznak. A pontokhoz és kérdőjelekhez hasonlóan zárójeleken kívülre kerülnek, ha a zárójel egy nagyobb mondat része, és zárójelek közé, ha a zárójel önmagában áll.

Soha ne használjon felkiáltójeleket hibaüzenetekben vagy figyelmeztetésekben. Ha kétség merül fel, kerülje!

Idézőjelek

Az idézőjeleket szavakra és betűkre, rövid művek címeire (például cikkek és versek) és közvetlen idézetekre való hivatkozáshoz használja.

A pontok és a vesszők idézőjelek közé tartoznak. Az idézőjeleken belüli kérdőjelek a logikát követik – ha a kérdőjel az idézet része, akkor belülre kerül. Ha olyan kérdést teszel fel, amely idézőjellel végződik, akkor az idézőjel az idézőjelen kívülre kerül.

Az idézőjeleken belüli idézetekhez szimpla idézőjeleket használj.

• Ki mondta, hogy “A bolond és a fánkja könnyen elválik”?
• Brad azt mondta: “Egyszer egy bölcs ember azt mondta nekem: “A bolond és a fánkja könnyen elválik egymástól.””

Semicolons

Kímélj meg a pontosvesszőktől. Általában hosszú, bonyolult mondatokat támogatnak, amelyeket könnyen le lehetne egyszerűsíteni. Próbálkozzon helyette az em kötőjellel (-), vagy egyszerűen kezdjen új mondatot.

Az írásjelek

Ne használjon írásjelet, kivéve, ha az egy cég- vagy márkanév része.

• Ben és Dan
• Ben & Jerry’s

People, places, and things

File extensions

Ha általában egy fájlkiterjesztés típusára utalunk, használjunk nagybetűket pont nélkül. A többes számhoz tegyen hozzá egy kis s betűt.

• GIF
• PDF
• HTML
• JPGs

Ha egy adott fájlra utal, a fájlnevet kisbetűvel kell írni:

• slowclap.gif
• MCBenefits.pdf
• ben-twitter-profile.jpg
• ilovedonuts.html

Főnevek

Ha az alany neme ismeretlen vagy irreleváns, használja az “ők”, “őket” és az “ő” névmást egyes számban. Használja az “ő/az/az” és az “ő/az/az” névmásokat a megfelelő módon. Ne használja az “egy” névmást névmásként.

A nemekről való írásról bővebben lásd: Írás az emberekről.

Idézetek

Ha idéz valakit egy blogbejegyzésben vagy más publikációban, használjon jelen időt.

• “A Mailchimp használata segítette a vállalkozásunk növekedését” – mondja Jamie Smith.”

Nevek és címek

Amikor először említ egy személyt írásban, hivatkozzon rá a kereszt- és vezetéknevén. Minden további említéskor a keresztnevén hivatkozzon rá.

A részlegek és csapatok nevét nagybetűvel írja (de a “csapat” vagy “részleg” szót nem).

• Marketing csapat
• Support részleg

Az egyes munkakörök címét nagybetűvel írja, ha egy adott szerepre hivatkozik. Ne írja nagybetűvel, ha általánosságban utal a szerepkörre.

• Az új marketingvezetőnk ma kezd.
• Az összes vezető fánkot evett.

Ne hivatkozzon valakire “ninja”-ként, “rocksztár”-ként vagy “varázsló”-ként, hacsak nem szó szerint az.

iskolák

Amikor először említ egy iskolát, főiskolát vagy egyetemet egy írásában, hivatkozzon rá a teljes hivatalos nevén. Minden további említéskor használja az általánosabb rövidítést.

• Georgia Institute of Technology, Georgia Tech
• Georgia State University, GSU

State, cities, and countries

A városok és államok nevét írja ki. Ne rövidítse le a városneveket.

Az AP Style szerint minden városhoz csatolni kell az államot, kivéve a következőket: Atlanta, Baltimore, Boston, Chicago, Cincinnati, Cleveland, Dallas, Denver, Detroit, Honolulu, Houston, Indianapolis, Las Vegas, Los Angeles, Miami, Milwaukee, Minneapolis, New Orleans, New York, Oklahoma City, Philadelphia, Phoenix, Pittsburgh, St. Louis, Salt Lake City, San Antonio, San Diego, San Francisco, Seattle, Washington.

Első említéskor írja ki az Egyesült Államok szót. A további említéseknél az US is jó. Ugyanez a szabály vonatkozik bármely más, közös rövidítéssel rendelkező országra vagy szövetségre (Európai Unió, EU; Egyesült Királyság, UK).

URL-ek és weboldalak

A weboldalak és webes kiadványok nevét nagybetűvel írjuk. Ne dőlt betűvel írja.

Kerülje az URL-ek helyesírását, de ha szükséges, hagyja el a http://www-t.

A Mailchimpről írva

Vállalatunk jogi személy neve “The Rocket Science Group, LLC”. Kereskedelmi nevünk a “Mailchimp.” A “The Rocket Science Group, LLC” kifejezést csak akkor használja, ha jogi dokumentumokat vagy szerződéseket ír. Egyébként használd a “Mailchimp”-et.”

A Mailchimp-ben mindig nagybetűvel írd az első “M”-et és kisbetűvel a “c”-t.

A Mailchimp-et “mi”-nek nevezd, ne “ez”-nek.

A márkás kifejezéseket, mint például a Mailchimp Presents, nagybetűvel írd. Az árképzési csomagok nevét (Premium, Standard, Essentials és Free) is nagybetűvel írjuk, hogy megkülönböztessük őket e jelzők általános használatától.

Ne írjuk nagybetűvel a leíró termék- vagy funkcióneveket, mint például az e-mail vagy a céloldalak.

• sablonok
• Mailchimp mobilalkalmazása
• Essentials terv

Más cégekről írva

Hangsúlyozza a cégek saját neveit önmagukra és termékeikre. Tartsa magát ahhoz, amit a hivatalos weboldalukon használnak.

• iPad
• YouTube
• Yahoo!

A vállalatra vagy termékre “ez”-ként (nem “ők”-ként) hivatkozzon.

Slang és szakzsargon

Írjon egyszerű angolsággal. Ha szakkifejezést kell használnod, röviden definiáld, hogy mindenki megértse.

• AMailchimp Ops csapata folyamatosan méretezi szervereinket, hogy felhasználóinknak nagyszerű élményt nyújtsanak termékeinkkel. Ennek egyik módja a shards, vagyis a partíciók, amelyek segítségével jobban tudjuk horizontálisan skálázni az adatbázis-infrastruktúránkat.

Szövegformázás

Dőlt betűvel jelölje egy hosszú mű (például egy könyv, film vagy album) címét, vagy hangsúlyozzon ki egy szót.

• Dunston Checks In
• Brandon nagyon szereti Dunston Checks In.

Használjon dőlt betűt, ha egy alkalmazáson belüli Mailchimp-elem példáját idézi, vagy ha lépésről-lépésre történő utasításokban hivatkozik a gombok és navigációs címkékre:

• Ha kész van, kattintson a Küldés gombra.
• A megszokott A/B tesztelési változók – a Tárgysor, a Feladó neve és a Küldés ideje – mostantól a Tartalom mellett akár 3 kombinációt is tesztelhet egyszerre egy változóból.

Ne használjon aláhúzott formázást, és ne használja a dőlt, félkövér, nagybetűs és aláhúzás bármilyen kombinációját.

Balra igazítsa a szöveget, soha ne középre vagy jobbra igazítsa.

A mondatok között hagyjon egy szóközt, soha ne kettőt.

Pozitívan írjon

Negatív nyelvezet helyett használjon pozitív nyelvezetet. A negatív nyelvezet felismerésének egyik módja az olyan szavak keresése, mint a “nem lehet”, “nem” stb.

• Igen: Ahhoz, hogy fánkot kapj, állj be a sorba.
• Nem: Nem kaphatsz fánkot, ha nem állsz be a sorba.