Our words should convey facts, make an emotional impact, and motivate people to act. Our writing reflects on Anaplan's credibility; the tone we seek is professional, knowledgeable, and respectful, and the copy should be easy and pleasant to read. Following are some ideas that can help you achieve our desired tone.
When you write ask yourself four questions:
While all content contributors and content managers should familiarize themselves with the full style guide below, the Quick Reference Summary offers a broad overview and examples of best practices. The Community team recommends printing or bookmarking the summary for easy access when authoring content.
Word list: If you have questions about Anaplan-specific words or terms (spelling, usage, punctuation, etc.) start by referencing the style guide word list. If a word is not covered specifically in the word list, refer to the resources below. Contact firstname.lastname@example.org with any questions.
Dictionary: Merriam-Webster. Online at this site.
Additional style reference: The New York Times. If a word or phrase you want to use is not covered by AP Style or Merriam-Webster, search the paper's website and follow the form they use. Bonus: though it's now inactive, the paper's After Deadline blog is a lively source of information.
Additional style reference: Chicago Manual of Style for citations only. See the Statistics and Citations section for details.
For U.S. addresses, use postal codes for states (CA, TX, NY, etc.). This is an exception from AP style. Use no state for cities on AP's dateline list.
Use American English spelling, grammar, and punctuation rules in all English-language materials, unless a piece is written by an EMEA/APAC resident for an all-EMEA/APAC audience. In that case, UK English rules apply; see the UK English section below.
Specific rules apply when referring to analyst firms (such as Gartner and Forrester). While you can refer to their citation policies (Gartner and Forrester), it's often fastest and best to contact Analyst Relations (email@example.com before you proceed.
Avoid best, only, fastest, unique, impossible, always, and other words and phrases that indicate something with no alternative or that we can't prove.
Use italics for:
Use bold type for:
Our calls to action (CTAs) should be direct, polite, and informative. In blogs, choose between two formats:
For related information, see the Links section below.
A hyphen is not needed in a two-word adjective in which the first word ends with ly. Example: "commonly held belief."
We diverge from AP Style in a few specific instances. They're noted throughout this style guide, and we've collected them here as well.
When you describe an event that happened in the past, as when writing an event or webinar recap, use past tense. This includes the quotes in your description.
Colons: Use colons to introduce lists, to introduce explanations, or for emphasis. Capitalize the first word after a colon only if it starts a complete sentence or is a proper noun.
Commas: Use the serial (or Oxford) comma—that is, the comma before and in a list of three or more things. This is an exception to AP Style. Example: "The Anaplan platform connects data, people, and plans."
Comma splice: Avoid connecting two sentences that have different subjects with a comma. For example, write "I didn't like the movie. It was way too long," not "I didn't like the movie, it was way too long." (The subject of the first sentence is I, but the subject of the second sentence is the movie.)
Dashes: See the Dashes and Hyphens section above.
Ellipses: Use an ellipsis (…) to indicate deleted words, but not to denote pauses. Use one space on either side of an ellipsis.
Exclamation points: Refrain from using them. Never use more than one per email or paragraph.
Periods: Use periods at the end of full sentences. Use one space after a period. Do not double space after a period.
Semicolons: Use semicolons to separate elements of a series when one or more segments of the series contain a comma. Example: I watched three movies: Love, Actually; Cars; and Toy Story.
When using pronouns (such as that, which, it, they, who, etc.), always be completely clear what the pronoun refers to. (That's the pronoun's antecedent.) If there's any ambiguity—any question of "What does it refer to in this sentence?"—then reword.
On social media—LinkedIn, Facebook, Twitter, Instagram, Google+, and other platforms—be:
Do not post on social media:
Always cite sources when quoting statistics. Do not use sources over three years old except to set historical context.
Avoid using the words stat or stats to refer to statistics.
When a piece is written in English by an EMEA/APAC resident for an EMEA/APAC audience, UK English spelling, grammar, and punctuation can apply. Here are some specifics:
When referring to Anaplan leaders, get their titles right, and keep them consistent.
|Name||Position||Bio on website?|
|Frank Calderoni||President and CEO||Yes|
|Anup Singh||Executive Vice President, Chief Financial Officer||Yes|
|Marilyn Miller||Chief People Officer||Yes|
|Simon Tucker||Chief Customer Officer||Yes|
|Maria Pergolino||Chief Marketing Officer||Yes|
|Steven Birdsall||Chief Revenue Officer||Yes|
|Sampath Gomatam||Vice President, Product Management||Yes|
|Jack Whyte||Global Vice President of Engineering||Yes|