Loading...
 

History: Content Style Guide

Preview of version: 13

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/
https://twitter.com/dirkriehle/status/1526488122531381248
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
Jeff Fix the formatting and linebreaks, add quotation marks, and remove the false slash equivalence between libre and Open Source. They are not on the same level. 16
View
Marc Laporte 15
View
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