From 9e688c30ebc533c7f96d3756b7e9cecbcd746048 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?benjamin=20melan=C3=A7on?= Date: Wed, 8 Jul 2020 10:35:39 -0400 Subject: [PATCH] Start tightening up, fixing links --- content-style-guide.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/content-style-guide.md b/content-style-guide.md index 9bf56d1..4bdc665 100644 --- a/content-style-guide.md +++ b/content-style-guide.md @@ -1,4 +1,4 @@ -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. For now, it has been heavily lifted from Mailchimp. +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 and available under a Creative Commons Attribution-NonCommercial 4.0 International license. This guide goes beyond basic grammar and style points. It’s not traditional in format or content. We break a number of grammar rules for clarity, practicality, or preference. @@ -8,18 +8,23 @@ This guide goes beyond basic grammar and style points. It’s not traditional in The Agaric Content Style Guide goes into depth on many subjects. It may be more information than you need. Here are the most important things to know. ### Principles + Good content is: + * Authentic, Useful and Appropriate ### Voice and tone + Agaric’s voice is: + * Confident but not arrogant * Cheerful but not pollyannaish * Unconstrained but not incomprehensible * 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. + +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. * Avoid gendered language and use the singular “they.”