agaric/documentation
10
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Revise to document what we do consistently that looks good, like sentence case for titles

Browse source
This commit is contained in:
benjamin melançon 2023-06-14 10:07:08 -04:00
parent 7fecce43c1
commit d31516cf1c
1 changed files with 5 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
content-style-guide.md
View file

@ -219,18 +219,15 @@ One exception is when you want to specifically emphasize the action over the sub
#### Capitalization
We use a few different forms of capitalization. Title case capitalizes the first letter of every word except articles, prepositions, and conjunctions. We use title case for the titles of pages, including blog posts and basic pages.
Sentence case capitalizes the first letter of the first word. We use sentence case for headlines, subheads, and headings as well as every other sentence. (We do **not** use title case, which capitalizes the first letter of every word except articles, prepositions, and conjunctions. Instead, we let the formatting of titles carry the weight and use the more natural sentence case.)
Sentence case capitalizes the first letter of the first word.
When writing out an e-mail address or website URL, use all lowercase.
micky@agaric.com
micky@agaric.coop
agaric.com
Do not capitalize random words in the middle of sentences. Here are some words that we never capitalize in a sentence. For more, see the Word list.
website
internet
online
e-mail
Do not capitalize words in the middle of sentences that are not proper nouns. We do not capitalize internet, web, or e-mail. For more, see the [word list](#word-list-specialized-vocabulary).
#### Contractions