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

More following Micky's rule of no contractions

Browse source
This commit is contained in:
benjamin melançon 2022-02-09 21:29:20 -05:00
parent cba08c9c49
commit 5364d0078a
1 changed files with 5 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
content-style-guide.md
View file

@ -128,13 +128,14 @@ Here are a few key elements of writing Agaric's voice. For more, see the Grammar
## Writing About People ## Writing About People
We write the same way we build software: with a person-first perspective. Whether you’re writing for an internal or external audience, it is important to write for and about other people in a way that’s compassionate, inclusive, and respectful. Being aware of the impact of your language will help make Agaric a better place to work and a better steward of our values in the world. In this section we will lay out some guidelines for writing about people with compassion, and share some resources for further learning. We write the same way we build software: with a person-first perspective. Whether you are writing for an internal or external audience, it is important to write for and about other people in a way that is compassionate, inclusive, and respectful. Being aware of the impact of your language will help make Agaric a better place to work and a better steward of our values in the world. In this section we will lay out some guidelines for writing about people with compassion, and share some resources for further learning.
### Age ### Age
Don’t reference a person’s age unless it’s relevant to what you’re writing. If it is relevant, include the person’s specific age, offset by commas. Do not reference a person's age unless it is relevant to what you are writing. If it is relevant, include the person's specific age, offset by commas.
The CEO, 16, just got her driver’s license. The CEO, 16, just got her driver's license.
Don’t refer to people using age-related descriptors like “young,” “old,” or “elderly.”
Do not refer to people using age-related descriptors like “young,” “old,” or “elderly.”
### Ability ### Ability