Loading...
 

History: Content Style Guide

Preview of version: 12

Expressions in use

OK to use Avoid (and why)
Free / Libre / Open Source
Free and Open Source
Open Source
opensource or open source or open-source Ref.: https://perens.com/2017/09/26/on-usage-of-the-phrase-open-source/
proprietary software Commercial software as it's ambiguous.

General tips

"&" vs. "and"
Generally, don’t use the ampersand in regular text, headings or titles as a replacement for "and" except inside tables or parentheses when space is limited, or in company names or other instances (paraphrased from https://www.probizwriters.com/PBW-blog/index.php/ampersand-usage/). See also When to use & instead of “and”.
Capitalization in headings
Capitalize the first, last, and other important words, including
    • Adjectives (tiny, large, etc.)
    • Adverbs (quietly, smoothly, etc.)
    • Nouns (tablet, kitchen, book)
    • Pronouns (they, she, he)
    • Subordinating conjunctions (when more than five letters); see list here.
    • Verbs (write, type, create)

See also https://www.scribbr.com/academic-writing/capitalization-titles-headings.

Currency
When you're referencing specific amounts of money, use the currency code, followed by the amount, with no space. (Source: https://docs.microsoft.com/en-us/style-guide/global-communications/currency )
+Example +The company generated BRL2.89 billion (USD1.42 billion) in net revenue in 2015.
+If it's clear which currency you mean, it's OK to use just the symbol. When referring to a specific amount in euros, use the euro symbol (€), not the word euros. +Examples +One of the largest companies in the United States, Adatum Corporation generated $1.42 billion in net revenue in 2015. +Adatum Corporation generated €1.42 billion in net revenue in 2015.


See also Branding Guidelines

History

Advanced
Information Version
Marc Laporte 14
View
Marc Laporte A Twitter thread 13
View
gary.cunningham-lee Added suggestion and more info about heading capitalization. 12
View
Rick Sapir currency 11
View
gary.cunningham-lee Added info about item. 10
View
gary.cunningham-lee Added item: capitalization in headings - to be decided. 9
View
Marc Laporte 8
View
Marc Laporte 7
View
Marc Laporte 6
View
Marc Laporte 5
View
Marc Laporte 4
View
Marc Laporte Thank you Gary! 3
View
Marc Laporte 2
View
Marc Laporte 1
View