From b74655e020bddd29fc0d2ab5056b341284b31aeb Mon Sep 17 00:00:00 2001 From: Bridget Date: Wed, 8 Jul 2020 16:58:40 +0000 Subject: [PATCH] Update content-style-guide.md --- content-style-guide.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content-style-guide.md b/content-style-guide.md index 1b537b4..9279457 100644 --- a/content-style-guide.md +++ b/content-style-guide.md @@ -1,6 +1,6 @@ # Agaric's Content Style Guide -This is our company style guide. It helps us write clear and consistent content. Please use it as a reference when you’re writing for Agaric. Adapted from [Mailchimp](https://styleguide.mailchimp.com/) and available under a Creative Commons Attribution-NonCommercial 4.0 International license. +This is our company style guide. It helps us write clear and consistent content. Please use it as a reference when you’re writing for Agaric. Adapted from [MailChimp](https://styleguide.mailchimp.com/) and available under a Creative Commons Attribution-NonCommercial 4.0 International license. ## TL;DR @@ -17,16 +17,16 @@ Good content is: Agaric’s voice is: * Confident but not arrogant -* Cheerful but not pollyannaish +* Cheerful but not Pollyanna-ish * Unconstrained but not incomprehensible -* Open (curious, eclectic) but not scattered +* Open, curious, eclectic, but not scattered ### Writing about people We write and build apps with a person-first perspective. Being aware of the impact of your language is one way for us to live out our [values](values). -* Don’t reference age or disability unless it’s relevant to what you’re writing. +* Don’t reference age or ability unless it’s relevant to what you’re writing. * Avoid gendered language and use the singular “they.” * When writing about a person, use their preferred pronouns; if you don’t know those, just use their name. * Related resource: [The Conscious Style Guide](https://consciousstyleguide.com/). @@ -136,9 +136,9 @@ Don’t reference a person’s age unless it’s relevant to what you’re writi The CEO, 16, just got her driver’s license. Don’t refer to people using age-related descriptors like “young,” “old,” or “elderly.” -### Disability +### Ability -Don’t refer to a person’s disability unless it’s relevant to what you’re writing. If you need to mention it, use language that emphasizes the person first: ”she has a disability” rather than “she is disabled.” When writing about a person with disabilities, don’t use the words “suffer,” “victim,” or “handicapped.” “Handicapped parking” is OK. +Don’t refer to a person’s ability unless it’s relevant to what you’re writing. If you need to mention it, use language that emphasizes the person first: ”she has a disability” rather than “she is disabled.” When writing about a person with disabilities, don’t use the words “suffer,” “victim,” or “handicapped.” “Handicapped parking” is OK. ### Gender and sexuality