Here are a few key elements of writing in Mindful’s grammatic style.
Headings and titles
Titles should almost always be title case. This includes titles of webinars, blog posts, book chapters when given its own page or title section, presentations, etc. We use the AP style for capitalization. To generate proper capitalization, go to this site, switch to Chicago, and enter the title—the site will automatically fix the title to the correct capitalization!
Headings should always be sentence case, aim to be in active voice, and have periods when composed in a full sentence.
Title |
Why the Text Channel Is a Must-Have to Meet Customers |
Headings |
Benefits of offering an SMS text channel
SMS is immediate.
Text messages get opened. |
Acronyms
If there’s a chance your reader won’t recognize an abbreviation or acronym, spell it out the first time you mention it. Then use the short version for all other references. If the abbreviation isn’t clearly related to the full version, specify in parentheses. If the abbreviation or acronym is well known, like API or HTML, use it instead (and don’t worry about spelling it out).
List of acceptable abbreviations: API, HTML, UX, CX, ACD, CCaaS
First use: multi-experience (MX)
Second use: MX
Bullets, lists, and colons
Colons
When written in a sentence, there are two ways colons should operate. If what follows a colon is a full sentence, then the first letter following a colon should be capitalized. If what follows is a fragmented sentence, then do not capitalize.
Full sentence |
Here’s the bottom line: He loved his chocolate cake. |
Incomplete |
He loved everything chocolate: bars, fondue, and cake. |
Bullets
Bullets are great! Make sure they’re capitalized and include a period if it’s a full sentence.
Capitalization
As mentioned above, titles should be title case, everything else should be sentence case.
If you are writing about a specific feature, the feature may be capitalized if it is a proprietary feature. The following features should be capitalized:
- Mindful Scheduler
- Mindful Callback
- Mindful Feedback
- Mindful Handoff
- Digital Intents
Commas
We use the Oxford Comma. In addition to the Oxford Comma, writers can use additional, unconventional commas where it would break up the sentence naturally if someone was speaking the sentence out loud.
Example |
Mindful was designed and developed with them in mind, and our teams continue to work with clients to make industry-leading recommendations. |
Date and time
Standard format |
May 12 at 9am Pacific | 12pm Eastern |
Alternative format |
May 12 at 9:00am PST | 12:00pm EST |
Australian format |
12 May at 9:00am AEST |
Dashes, hyphens, and parentheses in lieu of semicolons
Dashes/hyphens: Use em dashes (one of these — ) to separate quick thoughts and break up sentences. The goal here is not to stretch out a sentence, but to emphasize certain points, and break it up in a way that would sound natural if speaking the sentence out loud. We follow the Chicago style guide and use an em dash without any spaces around it.
Example |
Update call targets, priority queues, and more in seconds—all without filing an IT ticket. |
Semicolons: Since many people don’t understand the meaning behind using a semicolon (or the proper use thereof), if you’re about to use a semicolon, opt for an em dash instead.
Do |
It doesn’t have the immediacy of a phone call—nobody likes to hear, “Let me put you on hold while I look that information up.” |
Don’t |
It doesn’t have the immediacy of a phone call; nobody likes to hear, “Let me put you on hold while I look that information up.” |
Parentheses: This is another useful tool to break up a sentence and work in quick notes or sideline thoughts on the subject without derailing the point.
Example |
This is omnichannel (as opposed to multi-channel) support. |
Numbers
We follow the Chicago style, outlined below.
- Spell it out from zero to nine.
- Use digits for numbers higher than 10.
- For cents or amounts of $1 million or more, spell the words cents, million, billion, trillion(ex: $26.52, $100,200, $8 million, 6 cents).
- If you start a sentence with a number, no matter the amount, it should be spelled out (ex: “Sixty percent of customers chose callback.”)