Gramatyka i mechanika

Przestrzeganie pewnych zasad gramatyki i mechaniki pomaga nam zachować przejrzystość i spójność naszych tekstów. W tej sekcji przedstawimy nasz styl domowy, który ma zastosowanie do wszystkich naszych treści, chyba że w tym przewodniku zaznaczono inaczej. (W tej sekcji poruszamy wiele tematów – funkcja wyszukiwania pomoże Ci, jeśli szukasz czegoś w szczególności.)

Podstawy

Pisz dla wszystkich czytelników. Niektórzy ludzie będą czytać każde słowo, które napiszesz. Inni będą tylko pobieżnie czytać. Pomóż wszystkim czytać lepiej, grupując powiązane pomysły razem i używając opisowych nagłówków i podnagłówków.

Skup się na swojej wiadomości. Stwórz hierarchię informacji. Prowadź od głównego punktu lub najważniejszej treści, w zdaniach, akapitach, sekcjach i stronach.

Bądź zwięzły. Używaj krótkich słów i zdań. Unikaj zbędnych modyfikatorów.

Bądź konkretny. Unikaj niejasnego języka. Wycinaj zbędny szum.

Bądź konsekwentny. Trzymaj się wzorów kopiowania i punktów stylistycznych przedstawionych w tym przewodniku.

Wskazówki

Skróty i akronimy

Jeśli jest szansa, że Twój czytelnik nie rozpozna skrótu lub akronimu, przeliteruj go za pierwszym razem, gdy o nim wspomnisz. Następnie używaj skróconej wersji dla wszystkich innych odniesień. Jeśli skrót nie jest wyraźnie związany z pełną wersją, podaj go w nawiasie.

• Pierwsze użycie: Network Operations Center
• Drugie użycie: NOC
• Pierwsze użycie: Coordinated Universal Time (UTC)
• Drugie użycie: UTC

Jeśli skrót lub akronim jest dobrze znany, jak API lub HTML, użyj go zamiast niego (i nie martw się o jego przeliterowanie).

Active voice

Używaj głosu czynnego. Unikaj passive voice.

W active voice, podmiot zdania wykonuje czynność. W stronie biernej podmiot zdania wykonuje czynność.

• Tak: Marti zalogował się na konto.
• Nie: Marti zalogował się na konto.

Słowa takie jak „był” i „przez” mogą wskazywać, że piszesz w stronie biernej. Skanuj w poszukiwaniu tych słów i przerabiaj zdania, w których się pojawiają.

Jednym z wyjątków jest sytuacja, gdy chcesz szczególnie podkreślić działanie nad podmiotem. W niektórych przypadkach jest to w porządku.

• Your account was flagged by our Abuse team.

Capitalization

Używamy kilku różnych form kapitalizacji. Przypadek tytułu kapitalizuje pierwszą literę każdego słowa, z wyjątkiem artykułów, przyimków i spójników. Przypadek zdaniowy kapitalizuje pierwszą literę pierwszego słowa.

Pisząc adres e-mail lub adres URL strony internetowej, używaj małych liter.

• [email protected]
• mailchimp.com

Nie kapitalizuj przypadkowych słów w środku zdań. Oto kilka słów, których nigdy nie piszemy wielką literą w zdaniu. Aby uzyskać więcej, zobacz Listę słów.

• strona internetowa
• internet
• online
• email

Kontrakty

Są świetne! Nadają Twojemu pismu nieformalny, przyjazny ton.

Emoji

Emoji są zabawnym sposobem na dodanie humoru i wizualnego zainteresowania do twojego pisma, ale używaj ich rzadko i świadomie.

Liczby

Przeliteruj liczbę, gdy rozpoczyna ona zdanie. W innych przypadkach używaj liczebnika. Dotyczy to również liczebników porządkowych.

• Ten nowy pracownik rozpoczął pracę w poniedziałek, a 12 zacznie w przyszłym tygodniu.
• Zjadłem 3 pączki w Coffee Hour.
• Meg zdobyła 1 miejsce w zeszłorocznym konkursie Walktober.
• Gościliśmy grupę ósmoklasistów, którzy uczą się kodować.

Czasami dziwnie jest używać liczebnika. Jeśli jest to wyrażenie, w którym zwykle używa się liczb pisanych, pozostaw je w ten sposób.

• Przyjazny e-mail powitalny może pomóc w zrobieniu świetnego pierwszego wrażenia.
• To jest integracja strony trzeciej.
• Postaw swoją najlepszą stopę do przodu dzięki platformie marketingowej all-in-one, która rozwija się wraz z Tobą.
• Po wysłaniu biuletynu Freddie przybije Ci piątkę.

Liczby powyżej 3 cyfr otrzymują przecinki:

• 999
• 1,000
• 150,000

Wypisuj duże liczby w całości. Skracaj je, jeśli są ograniczenia przestrzenne, jak w tweecie lub na wykresie: 1k, 150k.

Daty

Zazwyczaj podawaj dzień tygodnia i miesiąc. Skróty tylko wtedy, gdy miejsce jest problemem w aplikacji.

• Sobota, 24 stycznia
• Sat.., Jan. 24

Decimals and fractions

Spell out fractions.

• Yes: two-thirds
• No: 2/3

Use decimal points when a number can’t be easily written out as a fraction, like 1.375 or 47.2.

Oprocentowanie

Używaj symbolu % zamiast pisać „procent”.”

Zakresy i rozpiętości

Używaj myślnika (-), aby wskazać zakres lub rozpiętość liczb.

• To trwa 20-30 dni.

Pieniądze

Pisząc o amerykańskiej walucie, używaj znaku dolara przed kwotą. Dołącz część dziesiętną i liczbę centów, jeśli jest większa niż 0.

• $20
• $19.99

Pisząc o innych walutach, stosuj ten sam format symbolu-liczby:

• ¥1
• €1

Numery telefonów

Pomiędzy liczbami stosuj myślniki bez spacji. Użyj kodu kraju, jeśli Twój czytnik znajduje się w innym kraju.

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

Temperatura

Używaj symbolu stopnia i skrótu F dla Fahrenheita.

• 98°F

Czas

Używaj cyfr i am lub pm, ze spacją między nimi. Nie używaj minut do podawania czasu w systemie godzinowym.

• 7 am
• 7:30 pm

Używaj myślnika pomiędzy czasami, aby wskazać przedział czasowy.

• 7 am-10:30 pm

Określ strefy czasowe, gdy piszesz o wydarzeniu lub czymś innym, co ludzie będą musieli zaplanować. Ponieważ Mailchimp znajduje się w Atlancie, domyślnie używamy ET.

Skróty stref czasowych w kontynentalnych Stanach Zjednoczonych są następujące:

• Czas wschodni: ET
• Central time: CT
• Mountain time: MT
• Pacific time: PT

W przypadku odwoływania się do międzynarodowych stref czasowych należy je przeliterować: Nepal Standard Time, Australian Eastern Time. Jeśli strefa czasowa nie ma ustalonej nazwy, użyj jej przesunięcia uniwersalnego czasu koordynowanego (UTC).

Skróty dekad w odniesieniu do tych z ostatnich 100 lat.

• the 00s
• the 90s

When referring to decades more than 100 years ago, be more specific:

• the 1900s
• the 1890s

Punctuation

Apostrofy

Najczęstszym zastosowaniem apostrofu jest uczynienie słowa possessive. Jeśli słowo już kończy się na s i jest w liczbie pojedynczej, dodajesz również 's. Jeżeli słowo kończy się na s i jest w liczbie mnogiej, po prostu dodaj apostrof.

• Złodziej pączków zjadł pączka Sama.
• Złodziej pączków zjadł pączka Chrisa.
• The donut thief ate the managers’ donuts.

Apostrofy mogą być również używane do oznaczenia, że opuściłeś kilka liter ze słowa, zwykle dla humoru lub podkreślenia. Jest to w porządku, ale rób to oszczędnie.

Kolumny

Użyj dwukropka (zamiast wielokropka, em myślnika lub przecinka), aby oddzielić listę.

• Erin zamówiła 3 rodzaje pączków: lukrowane, czekoladowe i dyniowe.

Możesz również użyć dwukropka, aby połączyć 2 powiązane wyrażenia. Jeżeli po dwukropku następuje pełne zdanie, pierwsze słowo piszemy wielką literą.

• Zostałem postawiony przed dylematem: Chciałem pączka, ale właśnie zjadłem bajgla.

Przecinki

Przy pisaniu listy należy używać przecinka szeregowego (znanego również jako przecinek oksfordzki).

• Tak: David podziwia swoich rodziców, Oprah i Justina Timberlake’a.
• Nie: David podziwia swoich rodziców, Oprah i Justina Timberlake’a.

W pozostałych przypadkach kieruj się zdrowym rozsądkiem. Jeśli nie jesteś pewien, przeczytaj zdanie na głos. Tam, gdzie zauważysz, że bierzesz oddech, użyj przecinka.

Kreski i myślniki

Użyj myślnika (-) bez spacji po obu stronach, aby połączyć słowa w jedno zdanie lub aby wskazać zakres lub przedział.

• first-time user
• Monday-Friday

Używaj myślnika (-) bez spacji po obu stronach, aby odsunąć na bok.

Używaj prawdziwego myślnika, a nie myślników (- lub –).

• Testy wielowariantowe – tylko jedna z naszych nowych funkcji Pro – mogą pomóc Ci rozwinąć biznes.
• Austin myślał, że Brad jest złodziejem pączków, ale się mylił – to była Lain.

Elipsy

Elipsy (…) mogą być używane do wskazania, że kończysz myśl. Używaj ich oszczędnie. Nie używaj ich dla podkreślenia lub dramatyzowania, i nie używaj ich w tytułach lub nagłówkach.

• „Gdzie się podziały te wszystkie pączki?” zapytała Christy. Lain odpowiedział: „Nie wiem…”

Elipsy, w nawiasach, mogą być również używane do pokazania, że pomijasz słowa w cytacie.

• „Kiedy w biegu wydarzeń ludzkich staje się konieczne, aby jeden naród rozwiązał opaski polityczne, które łączyły go z drugim, i przyjął wśród potęg ziemi, przyzwoity szacunek dla opinii ludzkości wymaga, aby ogłosił on przyczyny, które skłaniają go do separacji.”

Periods

Periods umieszcza się wewnątrz cudzysłowu. Umieszcza się je poza nawiasami, gdy nawias jest częścią większego zdania, a wewnątrz nawiasów, gdy nawias jest samodzielny.

• Christy powiedziała, „Zjadłam pączka.”
• Zjadłam pączka (i zjadłam też bajgla).
• Zjadłam pączka i bajgla. (Pączek należał do Sama.)

Zostaw pojedynczą spację między zdaniami.

Znaki zapytania

Znaki zapytania umieszcza się wewnątrz cudzysłowu, jeżeli są częścią cytatu. Podobnie jak kropki, umieszcza się je poza nawiasami, gdy nawias jest częścią większego zdania, a wewnątrz nawiasów, gdy nawias jest samodzielny.

Wykrzykniki

Wykrzykników należy używać oszczędnie i nigdy więcej niż jeden na raz. Są jak piątki z głów: Jeden dobrze wymierzony jest świetny, ale zbyt wiele może być denerwujących.

Wykrzykniki umieszcza się wewnątrz cudzysłowów. Podobnie jak kropki i znaki zapytania, są one umieszczane poza nawiasami, gdy nawias jest częścią większego zdania, i wewnątrz nawiasów, gdy nawias jest samodzielny.

Nigdy nie używaj wykrzykników w komunikatach o awariach lub alarmach. W razie wątpliwości, unikaj!

Cudzysłów

Używaj cudzysłowów w odniesieniu do słów i liter, tytułów krótkich prac (takich jak artykuły i wiersze) oraz bezpośrednich cytatów.

Periody i przecinki wchodzą w cudzysłów. Znaki zapytania w cytatach są logiczne – jeśli znak zapytania jest częścią cytatu, to jest w nim umieszczany. Jeśli zadajesz pytanie, które kończy się cytatem, wychodzi on poza cytat.

Używaj pojedynczych cudzysłowów dla cytatów w cudzysłowie.

• Kto powiedział: „Głupiec i jego pączek łatwo się rozstają”?
• Brad powiedział: „Pewien mądry człowiek powiedział mi kiedyś: 'Głupiec i jego pączek łatwo się rozchodzą.'”

Semicolons

Nie przesadzaj ze średnikami. Zazwyczaj wspierają one długie, skomplikowane zdania, które mogłyby być łatwo uproszczone. Zamiast tego spróbuj użyć myślnika em (-) lub po prostu zacznij nowe zdanie.

Ampersandy

Nie używaj ampersandów, chyba że jest to część nazwy firmy lub marki.

• Ben i Dan
• Ben & Jerry’s

Ludzie, miejsca i rzeczy

Rozszerzenia plików

Przy ogólnym odniesieniu do typu rozszerzenia pliku należy używać wszystkich wielkich liter bez kropki. Dodaj małą literę s, aby uzyskać liczbę mnogą.

• GIF
• PDF
• HTML
• JPG

Przy odnoszeniu się do konkretnego pliku, nazwa pliku powinna być pisana małymi literami:

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

Zaimki

Jeśli płeć podmiotu jest nieznana lub nieistotna, użyj „they”, „them” i „their” jako zaimka w liczbie pojedynczej. Użyj zaimków „he/him/his” i „she/her/her/her” odpowiednio do sytuacji. Nie używaj „one” jako zaimka.

Więcej na temat pisania o płci, zobacz Pisanie o ludziach.

Cytaty

Kiedy cytujesz kogoś we wpisie na blogu lub innej publikacji, używaj czasu teraźniejszego.

• „Korzystanie z programu Mailchimp pomogło w rozwoju naszej firmy” – mówi Jamie Smith.

Imiona i tytuły

Przy pierwszej pisemnej wzmiance o danej osobie należy używać jej imienia i nazwiska. Przy wszystkich innych wzmiankach należy używać imienia i nazwiska.

Nazwy działów i zespołów pisz wielką literą (ale nie słowo „zespół” lub „dział”).

• Zespół marketingowy
• Dział wsparcia

Nazwy poszczególnych stanowisk pisz wielką literą, gdy odnosisz się do konkretnej roli. Nie pisz wielką literą, gdy odnosisz się do roli w sposób ogólny.

• Nasz nowy kierownik ds. marketingu rozpoczyna pracę dzisiaj.
• Wszyscy kierownicy zjedli pączki.

Nie określaj kogoś mianem „ninja”, „gwiazdy rocka” lub „czarodzieja”, chyba że dosłownie nim jest.

Szkoły

Przy pierwszej wzmiance o szkole, college’u lub uniwersytecie w tekście, podaj jego pełną oficjalną nazwę. Przy wszystkich innych wzmiankach używaj jej bardziej powszechnego skrótu.

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

Stany, miasta i kraje

Wypisuj wszystkie nazwy miast i stanów. Don’t abbreviate city names.

Per AP Style, all cities should be accompanied by their state, with the exception of: Atlanta, Baltimore, Boston, Chicago, Cincinnati, Cleveland, Dallas, Denver, Detroit, Honolulu, Houston, Indianapolis, Las Vegas, Los Angeles, Miami, Milwaukee, Minneapolis, Nowy Orlean, Nowy Jork, Oklahoma City, Filadelfia, Phoenix, Pittsburgh, St. Louis, Salt Lake City, San Antonio, San Diego, San Francisco, Seattle, Washington.

Przy pierwszej wzmiance należy pisać United States. W kolejnych wzmiankach, US jest w porządku. Ta sama zasada dotyczy każdego innego kraju lub federacji ze wspólnym skrótem (Unia Europejska, UE; Wielka Brytania, UK).

URL i strony internetowe

Nazwy stron internetowych i publikacji internetowych pisz wielką literą. Nie pisz kursywą.

Unikaj literowania adresów URL, ale gdy musisz, opuść http://www.

Pisanie o Mailchimp

Nazwa prawna naszej firmy to „The Rocket Science Group, LLC.”. Nasza nazwa handlowa to „Mailchimp.” Używaj „The Rocket Science Group, LLC” tylko wtedy, gdy piszesz dokumenty prawne lub umowy. W pozostałych przypadkach używaj „Mailchimp.”

Zawsze pisz pierwszą literę „M” wielkimi literami, a „c” w słowie Mailchimp małymi literami.

Odnoś się do Mailchimp jako „my”, a nie „ono.”

Kapitalizuj nazwy marek, takie jak Mailchimp Presents. Piszemy również wielkimi literami nazwy planów cenowych (Premium, Standard, Essentials i Free), aby odróżnić je od ogólnego użycia tych przymiotników.

Nie pisz wielkimi literami opisowych nazw produktów lub funkcji, takich jak wiadomości e-mail lub strony docelowe.

• szablony
• Aplikacja mobilna firmy Mailchimp
• Plan Essentials

Pisanie o innych firmach

Honoruj nazwy własne firm dla siebie i swoich produktów. Kieruj się tym, co jest używane na ich oficjalnej stronie internetowej.

• iPad
• YouTube
• Yahoo!

Odnoś się do firmy lub produktu jako „ona” (nie „oni”).

Slang i żargon

Pisz prostym angielskim. Jeśli musisz użyć terminu technicznego, krótko go zdefiniuj, aby wszyscy mogli go zrozumieć.

• Zespół operacyjny firmy Mailchimp nieustannie skaluje nasze serwery, aby zapewnić użytkownikom doskonałe wrażenia z korzystania z naszych produktów. Jednym ze sposobów, w jaki to robimy, są shardy lub partycje, które pomagają nam lepiej skalować poziomo naszą infrastrukturę bazy danych.

Formatowanie tekstu

Używaj kursywy, aby wskazać tytuł długiego utworu (takiego jak książka, film lub album) lub podkreślić słowo.

• Dunston Checks In
• Brandon naprawdę uwielbia Dunston Checks In.

Kursywy używaj, gdy przytaczasz przykład elementu aplikacji Mailchimp lub odwołujesz się do etykiet przycisków i nawigacji w instrukcjach krok po kroku:

• Gdy skończysz, kliknij przycisk Wyślij.
• Znane zmienne testowania A/B – Linia tematu, Od nazwy i Czas wysłania – zostały teraz połączone z Treścią, a teraz można testować do 3 kombinacji jednej zmiennej jednocześnie.

Nie używaj formatowania z podkreśleniem i nie używaj żadnej kombinacji kursywy, pogrubienia, kapitalików i podkreślenia.

Wyrównaj tekst do lewej, nigdy do środka ani do prawej.

Zostaw jeden odstęp między zdaniami, nigdy dwa.

Pisz pozytywnie

Używaj raczej języka pozytywnego niż negatywnego. Jednym ze sposobów na wykrycie negatywnego języka jest szukanie słów takich jak „nie mogę”, „nie”, itp.

• Tak: Aby dostać pączka, stań w kolejce.
• Nie: Nie możesz dostać pączka, jeśli nie staniesz w kolejce.

.