Master Text Style Guide
Master Text Style Guide
Master Text Style Guide
Think before you write, and edit out loud after you write. You can always make the first draft
better.
Always think and write from the reader’s perspective. Think about who you are writing for before
you write.
Do not use the same noun, verb, or adjective in the same sentence.
When there are more than two nouns in a sentence, do not use pronouns more than twice in a
row.
Bad: All business processes have deadlines associated to them, but many of them fail to
make them.
Better: All business processes have deadlines, but many fail to meet them.
Put the most important information in a sentence at the end. This leads the reader to the end of
the sentence.
Remove unnecessary words.
You may from time to time break any guideline in this section; but you must have a damn good
reason for doing it.
Article Guidelines
When submitting articles:
● Everything is left-aligned
● Use Arial point 11
● 1.15 line spacing with 10 point spacing between paragraphs
● Do not add a line break between paragraphs
● Use the H1 tag for the title of the article, H2 tags for section headings, and H3 tags when
giving multiple examples inside a section
● The title of the article (H1) should be in Title Case. The section headings/ subheadings
should be in Sentence case
Topics
Abbreviations
Unless the abbreviation is more common than the actual name (UN, UNESCO, NGO), always
write out an abbreviation the first time it is used followed by parentheses with the abbreviated
form. You may use the term BPM without any explanation.
Apostrophe and Contractions
When a word ends in an ‘s’ that requires a possessive, the final ‘s’ is omitted
Jonas’, ITProjects’
Contractions are fine to use in any form. However, do not contract the verb “to have” when it is
the main verb in the sentence.
Bold Text
Only use bold text when you want to overemphasize something, often in a comedic or
over-the-top manner.
Book Titles
When referring to the title of a book, add italics.
Bullets
Use bullets when creating a separate subsection. Do not use numbers or letters (e.g. ‘1)’ or ‘a)’).
Keep bullet points to a single sentence and do not add final punctuation.
If bulleted sentences must extend to two sentences, then use final punctuation for all items, and
for all items on the entire page.
Capitalization
The following are always capitalized, regardless of the situation:
The following are not capitalized (unless they are in a heading or the first word of a sentence)
Industries
Financial terms
Concepts
Departments (finance, procurement, administration)
Job titles are capitalized if they are referring to an actual person’s designation that would appear
on a visiting card:
If you are a business development manager, you’ll want to check this out.
Casing
● Sentence Case - The first letter of the first word is capitalized. All other words begin in
lower case unless it is a proper noun, or follows a different grammar rule.
● Title Case - Capitalize every word, unless all of these conditions are met:
○ It is an article, preposition, or conjunction
○ It is three letters or less
○ It is not the first or last word
○ Examples:
■ a, an, and, by, for, in, of, on, or, so, the, to
○ Note:
■ All verbs, including helping verbs and phrasal verbs are always
capitalized, including is, are, has, can, and be
○ For hyphenated words that appear in titles and section headings, capitalize both
parts, e.g. Time for Some Self-Assessment
The most important principle is to maintain consistent casing across the user experience.
Lean towards using sentence casing in most situations and title casing only when absolutely
required.
Commas
Include a comma between the last two items in a list.
Dashes
When using a dash to trigger a reader to pause while reading, use the em dash –. Use a space
before or after the dash.
Developers thought they had found the problem – until they realized it was bigger than
they thought.
Latin Endings
Meanings
● etc. = “and so on”
● i.e. = “that is”
● e.g. = “for example”
If you use the phrase “such as”, “including”, or “like” in a sentence, do not include “etc.” at the
end of the list.
You can find all kinds of junk food like pizza, potato chips, or burgers.
They ate anything they wanted – pizza, potato chips, burgers, etc.
There are many types of junk food such as pizza, potato chips, or burgers.
I love all junk food, e.g. burgers, potato chips, pizza.
Numbers
General
Numbers should be written out up to twenty. After that, they should be symbols.
There are 25 new product lines in the works, but only thirteen will be selected.
All numbers (including currencies) below one million should include all the digits along with a
comma to show the thousands place. Numbers one million and above should always include the
initial digits and then the word ‘million’ or ‘billion’. In this case, a decimal should be used instead
of a comma, and no more than two digits after the decimal.
Currency
The symbol ‘$’ should be used for dollars, without any prefix.
Percentages
Use digits for the numbers and write out the word percent. Do not use the symbol (%). Do not
say “16 percentage”.
Point of View
Most articles should be written in second person, directly addressing the audience you are
trying to reach.
Never write in first person unless you are the authority on the topic. This includes 1st person
plural (“we”).
If a section heading is written as a dialogue, it should be written in sentence case, e.g. ...but
what about my data?
Quotation Marks
Double quotation marks are used when you are directly quoting someone else’s speech or text.
Offset the quote with a comma and keep any final punctuation inside the quote.
The new clients asked, “Are you extremely satisfied?” Everyone was astonished.
Single quotation marks are used when referring to terminology (often dubious). No comma is
needed and final punctuation should be outside the quote marks.
Only a magnetic workplace that continues to attract talent can sustain the generation of ‘job
hoppers’.
Do not use quotation marks to emphasize a term or try to make it stand out.
Slash
In most cases, there are no spaces before or after a slash:
The product is useful for companies/organizations
The product is useful for Chief Technology Officers/Heads of Departments
Some exceptions can be made, but very rarely. For longer phrases separated by a slash, rewrite the
sentence so as not to use the slash.
Split Infinitives
Make sure not to never do it :-)
Wrong: You should be able to easily add a branch and create conditional tasks.
Right: You should be able to add a branch and create conditional tasks easily.
Symbols
Do not use the ‘&’ symbol to mean ‘and’ unless it is part of a company name.
Tense
Avoid the progressive and perfect tenses where possible. Opt for simple past and simple
present.
NOT The company had done a study; The company did a study.
NOT They will be growing at 8 percent. They will grow at 8 percent.
Versus
Versus should be written as vs.
The cloud vs. on-premise debate is pretty much over.
Voice
Use active voice rather than passive.