Grammatik och mekanik

Att följa vissa regler för grammatik och mekanik hjälper oss att hålla våra texter tydliga och konsekventa. I det här avsnittet beskrivs vår stil, som gäller för allt vårt innehåll om inget annat anges i den här guiden. (Vi täcker en hel del områden i det här avsnittet – sökfunktionen hjälper dig om du letar efter något särskilt.)

Basics

Skriv för alla läsare. Vissa människor kommer att läsa varje ord du skriver. Andra kommer bara att skumma. Hjälp alla att läsa bättre genom att gruppera relaterade idéer och använda beskrivande rubriker och underrubriker.

Fokusera ditt budskap. Skapa en hierarki av information. Börja med huvudpoängen eller det viktigaste innehållet, i meningar, stycken, avsnitt och sidor.

Var kortfattad. Använd korta ord och meningar. Undvik onödiga modifieringar.

Var specifik. Undvik vagt språk. Skippa det ovidkommande.

Var konsekvent. Håll dig till de kopieringsmönster och stilpunkter som beskrivs i den här guiden.

Riktlinjer

Abkortningar och akronymer

Om det finns en chans att din läsare inte känner igen en förkortning eller akronym, skriv ut den första gången du nämner den. Använd sedan den korta versionen för alla andra hänvisningar. Om förkortningen inte har ett tydligt samband med den fullständiga versionen, ange det inom parentes.

• Första användningen: Network Operations Center
• Till första användning: Network Operations Center
• Till andra användning: Network Operations Center: NOC
• Första användning: Coordinated Universal Time (UTC)
• Second use: Coordinated Universal Time (UTC)
• Second use: Coordinated Universal Time: UTC

Om förkortningen eller akronymen är välkänd, t.ex. API eller HTML, använd den istället (och oroa dig inte för att stava den).

Aktiv röst

Använd aktiv röst. Undvik passiv röst.

I aktiv röst är det subjektet i meningen som utför handlingen. I passiv röst får subjektet i meningen handlingen utförd.

• Ja: Marti loggade in på kontot.
• Nej: Kontot loggades in av Marti.

Ord som ”var” och ”av” kan tyda på att du skriver i passiv röst. Sök efter dessa ord och omarbeta meningar där de förekommer.

Ett undantag är när du specifikt vill betona handlingen framför ämnet. I vissa fall går detta bra.

• Ditt konto flaggades av vårt team för missbruk.

Kapitalisering

Vi använder några olika former av kapitalisering. I titelbokstavsform aktiveras första bokstaven i varje ord utom artiklar, prepositioner och konjunktioner. I meningstillhörighet skrivs första bokstaven i det första ordet med stor bokstav.

När du skriver ut en e-postadress eller webbadress till en webbplats använder du små bokstäver.

• [email protected]
• mailchimp.com

Gör inte slumpmässigt valda ord i mitten av meningar med stor bokstav. Här är några ord som vi aldrig skriver med stor bokstavsbeteckning i en mening. För fler, se ordlistan.

• webbplats
• internet
• online
• email

Kontrakt

De är fantastiska! De ger ditt skrivande en informell, vänlig ton.

Emoji

Emoji är ett roligt sätt att lägga till humor och visuellt intresse i ditt skrivande, men använd dem sällan och medvetet.

Nummer

Skriv ut ett nummer när det börjar en mening. I annat fall använder du siffran. Detta gäller även ordinaler.

• Tio nya anställda började i måndags och tolv börjar nästa vecka.
• Jag åt tre munkar på Coffee Hour.
• Meg vann 1:a plats i förra årets Walktober-tävling.
• Vi var värdar för en grupp åttondeklassare som lär sig att koda.

Ibland känns det konstigt att använda siffran. Om det är ett uttryck som vanligtvis använder stavade siffror, låt dem vara det.

• Ett vänligt välkomstmejl kan hjälpa dig att göra ett bra första intryck.
• Det är en tredjepartsintegration.
• Sätt din bästa fot framåt med en allt-i-ett-marknadsföringsplattform som växer med dig.
• När du har skickat ditt nyhetsbrev kommer Freddie att ge dig en high-five.

Nummer över 3 siffror får kommatecken:

• 999
• 1 000
• 150 000

Skriv ut stora nummer i sin helhet. Förkorta dem om utrymmet är begränsat, t.ex. i en tweet eller ett diagram: 1k, 150k.

Datum

Skriv vanligtvis ut veckodagen och månaden. Förkorta endast om utrymmet är ett problem i appen.

• Lördagen den 24 januari
• Sat, 24 jan.

Decimaler och bråk

Skriv ut bråk.

• Ja: två tredjedelar
• Nej: 2/3

Använd decimaltecken när ett tal inte enkelt kan skrivas ut som ett bråk, som 1,375 eller 47,2.

Procentandelar

Använd symbolen % i stället för att stava ut ”procent”.

Sortiment och spännvidder

Använd ett bindestreck (-) för att ange ett intervall eller spännvidd av tal.

• Det tar 20-30 dagar.

Pengar

När du skriver om amerikansk valuta använder du dollartecknet före beloppet. Inkludera en decimal och antalet cent om det är mer än 0.

• $20
• $19.99

När du skriver om andra valutor följer du samma format för symbol och belopp:

• ¥1
• €1

Telefonnummer

Använd streck utan mellanslag mellan siffrorna. Använd en landskod om läsaren befinner sig i ett annat land.

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

Temperatur

Använd gradsymbolen och förkortningen F med versal för Fahrenheit.

• 98°F

Tid

Använd siffror och am eller pm, med ett mellanslag. Använd inte minuter för timtid.

• 7 am
• 7:30 pm

Använd ett bindestreck mellan tider för att ange en tidsperiod.

• 7 am-10:30 pm

Ange tidszoner när du skriver om ett evenemang eller något annat som folk skulle behöva planera. Eftersom Mailchimp ligger i Atlanta använder vi som standard ET.

Förkortar tidszoner inom kontinentala USA på följande sätt:

• Eastern time: ET
• Centraltid: CT
• Mountain time: MT
• Stillahavstid: PT

Om du hänvisar till internationella tidszoner, skriv ut dem: Nepal Standard Time, Australian Eastern Time. Om en tidszon inte har något fastställt namn använder du dess UTC-förskjutning (Coordinated Universal Time).

Förkortar decennier när du hänvisar till de senaste 100 åren.

• 100-talet
• 90-talet

Vid hänvisning till decennier som ligger mer än 100 år tillbaka i tiden ska du vara mer specifik:

• 1900-talet
• 1890-talet

Teckensättning

Apostrofer

Apostrofens vanligaste användning är att göra ett ord possessivt. Om ordet redan slutar på ett s och det är singulariserat lägger man också till ett s. Om ordet slutar på ett s och är i plural lägger du bara till en apostrof.

• Donuttjuven åt Sams donut.
• Donuttjuven åt Chris donut.
• Den donuttjuven åt chefernas donuts.

Apostrofer kan också användas för att ange att du har släppt några bokstäver från ett ord, vanligen för humor eller betoning. Detta går bra, men gör det sparsamt.

Kolon

Använd ett kolon (i stället för en ellips, ett em-streck eller ett kommatecken) för att förskjuta en lista.

• Erin beställde 3 sorters munkar: glaserade, choklad och pumpaknölar.

Du kan också använda ett kolon för att sammanfoga 2 relaterade fraser. Om en fullständig mening följer efter kolonet, skriv det första ordet med versaler.

• Jag stod inför ett dilemma: jag ville ha en munk, men jag hade just ätit en bagel.

Komma

När du skriver en lista ska du använda det seriella kommatecknet (även känt som Oxfordkommatecknet).

• Ja: David beundrar sina föräldrar, Oprah och Justin Timberlake.
• Nej: David beundrar sina föräldrar, Oprah och Justin Timberlake.

Andra annars sunt förnuft. Om du är osäker kan du läsa meningen högt. Om du tycker att du tar ett andetag, använd ett kommatecken.

Dashes och bindestreck

Använd bindestreck (-) utan mellanslag på vardera sidan för att länka samman ord till en enda fras, eller för att indikera en spännvidd eller ett område.

• Förstagångsanvändare
• Måndag-fredag

Använd ett em-streck (-) utan mellanslag på vardera sidan för att förskjuta ett sidospår.

Använd ett riktigt em-streck, inte bindestreck (- eller –).

• Multivariat testning – bara en av våra nya Pro-funktioner – kan hjälpa dig att utveckla din verksamhet.
• Austin trodde att Brad var donuttjuven, men han hade fel – det var Lain.

Ellipser

Ellipser (…) kan användas för att indikera att du drar ut på tiden före slutet av en tanke. Använd dem sparsamt. Använd dem inte för att betona eller dramatisera och använd dem inte i titlar eller rubriker.

• ”Vart tog alla munkar vägen?” Christy frågade. Lain svarade: ”Jag vet inte…”

Ellipser, inom parentes, kan också användas för att visa att du utelämnar ord i ett citat.

• ”När det i de mänskliga händelsernas förlopp blir nödvändigt för ett folk att upplösa de politiska band som har förbundit dem med ett annat och ta plats bland jordens makter, kräver en anständig respekt för mänsklighetens åsikter att de förklarar de orsaker som driver dem till separationen.”

Perioder

Perioder ska stå inom citationstecken. De går utanför parenteser när parentesen är en del av en större mening, och innanför parenteser när parentesen står för sig själv.

• Christy sa: ”Jag åt en munk.”
• Jag åt en munk (och jag åt en bagel också).
• Jag åt en munk och en bagel. (Donuten var Sams.)

Lämna ett enkelt mellanslag mellan meningarna.

Frågetecken

Frågetecken ska stå inom citattecken om de är en del av citatet. Liksom punkter ska de placeras utanför parenteser när parentesen är en del av en större mening och inom parenteser när parentesen står för sig själv.

Uppropstecken

Använd utropstecken sparsamt, och aldrig mer än ett åt gången. De är som high-fives: Ett vältajmat är bra, men för många kan vara irriterande.

Utropstecken ska stå inom citationstecken. Precis som punkt och frågetecken ska de placeras utanför parenteser när parentesen är en del av en större mening och inom parenteser när parentesen står för sig själv.

Använd aldrig utropstecken i felmeddelanden eller varningar. Om du är osäker, undvik det!

Angivenhetstecken

Angivenhetstecken används för att hänvisa till ord och bokstäver, titlar på korta verk (t.ex. artiklar och dikter) och direkta citat.

Perioder och kommatecken hör hemma inom angivenhetstecken. Frågetecken inom citat följer logiken – om frågetecknet är en del av citatet, hör det till citatet. Om du ställer en fråga som avslutas med ett citat, hamnar det utanför citatet.

Använd enkla citationstecken för citat inom citat.

• Vem var det som sa: ”En dåre och hans donut skiljs lätt åt”?
• Brad sa: ”En klok man sa en gång till mig: ’En dåre och hans donut skiljs lätt åt’.”

Semikolon

Sköt dig med semikolonerna. De stöder vanligtvis långa, komplicerade meningar som lätt skulle kunna förenklas. Försök med ett em-streck (-) i stället, eller börja helt enkelt en ny mening.

Ampersander

Använd inte ampersand om inte ett ampersand ingår i ett företags- eller varumärkesnamn.

• Ben och Dan
• Ben &Jerry’s

Personer, platser och saker

Filtillägg

När du hänvisar generellt till en typ av filändelse ska du använda alla versaler utan punkt. Lägg till ett litet s för att göra plural.

• GIF
• PDF
• HTML
• JPGs

När man hänvisar till en specifik fil ska filnamnet skrivas med små bokstäver:

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

Pronoäng

Om ditt subjekts kön är okänt eller ointressant använder du ”de”, ”dem” och ”deras” som singularpronomen. Använd pronomen som ”han/hon/his” och ”hon/hon/henne” när det är lämpligt. Använd inte ”en” som pronomen.

För mer information om att skriva om kön, se Skriva om människor.

Citat

Om du citerar någon i ett blogginlägg eller annan publikation, använd nutid.

• ”Att använda Mailchimp har hjälpt vårt företag att växa”, säger Jamie Smith.

Namn och titlar

Den första gången du nämner en person i skrift ska du referera till den med för- och efternamn. Vid alla andra omnämnanden hänvisar du till dem med deras förnamn.

Namn på avdelningar och team ska skrivas med versal (men inte ordet ”team” eller ”avdelning”).

• Marknadsföringsteam
• Supportavdelning

Namn på enskilda jobbtitlar ska skrivas med versal när du hänvisar till en specifik roll. Skriv inte med versaler när du hänvisar till rollen i allmänna termer.

• Vår nya marknadschef börjar idag.
• Alla chefer åt munkar.

Omnämn inte någon som ”ninja”, ”rockstjärna” eller ”trollkarl” om de inte bokstavligen är det.

Skolor

Den första gången du nämner en skola, ett universitet eller en högskola i en skrift ska du hänvisa till den med dess fullständiga officiella namn. Vid alla andra omnämnanden använder du dess vanligare förkortning.

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

Stater, städer och länder

Boksta alla namn på städer och stater. Förkorta inte stadsnamn.

Enligt AP Style ska alla städer åtföljas av sin delstat, med undantag för: 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 och Washington. Vid efterföljande omnämnanden är US okej. Samma regel gäller för alla andra länder eller federationer med en gemensam förkortning (Europeiska unionen, EU; Förenade kungariket, UK).

URL:er och webbplatser

Namn på webbplatser och webbpublikationer skrivs med versaler. Kursivera inte.

Underlämn inte webbadresser med stavning, men när du behöver det, låt bli http://www.

Skriv om Mailchimp

Vårt företags juridiska namn är ”The Rocket Science Group, LLC”. Vårt handelsnamn är ”Mailchimp.” Använd ”The Rocket Science Group, LLC” endast när du skriver juridiska dokument eller kontrakt. Annars använder du ”Mailchimp”.

Skapa alltid det första ”M” med stor bokstav och skriv ”c” med liten bokstav i Mailchimp.

Använd Mailchimp som ”vi”, inte ”det”.

Genomför märkesbeteckningar, till exempel Mailchimp Presents, med stor bokstav. Vi skriver också namn på prissättningsplaner (Premium, Standard, Essentials och Free) med stor bokstavsbeteckning för att skilja dem från generisk användning av dessa adjektiv.

Skriv inte beskrivande produkt- eller funktionsnamn med stor bokstavsbeteckning, till exempel e-post eller landningssidor.

• mallar
• Mailchimp’s mobile app
• Essentials plan

Skriva om andra företag

Honorera företagens egna namn för sig själva och sina produkter. Gå efter vad som används på deras officiella webbplats.

• iPad
• YouTube
• Yahoo!

Omnämn ett företag eller en produkt som ”det” (inte ”de”).

Slang och jargong

Skriv på klarspråk. Om du behöver använda en teknisk term, definiera den kortfattat så att alla kan förstå.

• Mailchimp’s Ops-team skalar ständigt våra servrar för att se till att våra användare får en bra upplevelse av våra produkter. Ett sätt vi gör detta är med shards, eller partitioner, som hjälper oss att bättre skala vår databasinfrastruktur horisontellt.

Textformatering

Använd kursiv stil för att ange titeln på ett långt verk (t.ex. en bok, film eller ett album) eller för att betona ett ord.

• Dunston Checks In
• Brandon älskar verkligen Dunston Checks In.

Använd kursiv stil när du citerar ett exempel på ett Mailchimp-element i appen eller hänvisar till knapp- och navigeringsbeteckningar i steg-för-steg-instruktioner:

• När du är klar klickar du på Skicka.
• De välkända variablerna för A/B-testning – Subject line, From name och Send time – har nu fått sällskap av Content, och upp till tre kombinationer av en enskild variabel kan nu testas samtidigt.

Använd inte understrykningsformatering och använd ingen kombination av kursiv, fet, versaler och understrykning.

Vänsterjustera text, aldrig centrerad eller högerjusterad.

Lämna ett mellanslag mellan meningarna, aldrig 2.

Skriv positivt

Använd positivt språk snarare än negativt språk. Ett sätt att upptäcka negativt språk är att leta efter ord som ”kan inte”, ”inte” osv.

• Ja: För att få en munk ska du ställa dig i kö.
• Nej: Du kan inte få en munk om du inte ställer dig i kö.