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

Update information about Voice and try to fix bullets

Browse source
This commit is contained in:
benjamin melançon 2022-02-09 22:18:15 -05:00
parent e7e281628d
commit f73aff65f0
1 changed files with 19 additions and 25 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
content-style-guide.md
View file

@ -4,22 +4,16 @@ Please reference this styleguide when writing for Agaric to keep our communicati
## Summary ## Summary
Good content is: Good content is authentic, useful, and appropriate to its context.
* Authentic, useful, and appropriate Agaric's voice is straightforward, bold, and irreverant.
Agaric's voice is:
* Confident but not arrogant
* Upbeat but not in denial
* Unconstrained but not incomprehensible
* Open, curious, eclectic; but not scattered
### Writing about people ### Writing about people
We write and build apps with a person-first perspective. Being aware of the impact of language is one way for us to live out our [values](values). We write and build apps with a person-first perspective. Being aware of the impact of language is one way for us to live out our [values](values).
* Do not reference age or ability unless it is relevant to what you're writing. * Do not reference age or ability unless it is immediately relevant.
* Avoid gendered language and use the singular they. * Avoid gendered language and use the singular they.
* When writing about a person, use their preferred pronouns; if you do not know those, use their name. * When writing about a person, use their preferred pronouns; if you do not know those, use their name.
* Related resource: [The Conscious Style Guide](https://consciousstyleguide.com/). * Related resource: [The Conscious Style Guide](https://consciousstyleguide.com/).
@ -96,9 +90,9 @@ We strive to have the same voice all the time, but our tone changes to suit the
Agaric's voice is: Agaric's voice is:
* Straightforward and earnest * Straightforward and earnest.
* Unafraid of bold and even visionary calls to action * Unafraid of bold and even visionary calls to action.
* * Irreverant; the human condition is too serious to take anything too seriously.
### Tone ### Tone