Fix and remove some more contractions

This commit is contained in:
benjamin melançon 2020-08-14 14:59:08 -04:00
parent 4576f15e22
commit 0f0d9bc9d6

View file

@ -26,9 +26,9 @@ Agarics voice is:
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). 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).
* Dont reference age or ability unless its relevant to what youre writing. * Do not reference age or ability unless it is relevant to what youre writing.
* 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 dont know those, just 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/).
@ -46,7 +46,7 @@ Focus your message, and create a hierarchy of information. Lead with the main po
* Be consistent. Adhere to the copy patterns and style points outlined in this guide. * Be consistent. Adhere to the copy patterns and style points outlined in this guide.
* Do not use contractions as they cheapen the content and provide difficulty for readers of other languages. * Do not use contractions as they cheapen the content and provide difficulty for readers of other languages.
* Use the serial comma. Otherwise, use common sense. (Also known as the Oxford comma, it helps clarify when items in a list of three, four, or more things are their own items.) * Use the serial comma. Otherwise, use common sense. (Also known as the Oxford comma, it helps clarify when items in a list of three, four, or more things are their own items.)
* Dont use underline, and dont use any combination of italic, bold, caps, and underline. * Do not use underline for emphasis, and do not use any combination of italic, bold, caps, and underline.
* When in doubt, read your writing out loud. * When in doubt, read your writing out loud.
Many of these repeat or reinforce George Orwell's six rules from his essay "Politics and the English Language" (1946), and it is worth keeping all of them in mind, especially the last: Many of these repeat or reinforce George Orwell's six rules from his essay "Politics and the English Language" (1946), and it is worth keeping all of them in mind, especially the last:
@ -76,7 +76,7 @@ Place similar topics in the same paragraph, and clearly separate different topic
* Avoid double negatives. * Avoid double negatives.
* Do not use contractions as they cheapen the content and provide difficulty for readers that do not speak English of other languages. * Do not use contractions as they cheapen the content and provide difficulty for readers that do not speak English of other languages.
* Avoid using synonyms for the same word in a single piece of writing. * Avoid using synonyms for the same word in a single piece of writing.
* Write briefly, but dont sacrifice clarity for brevity. You may need to repeat or add words to make the meaning of your sentences clear to a translator. * Write briefly, but do not sacrifice clarity for brevity. You may need to repeat or add words to make the meaning of your sentences clear to a translator.
* Avoid slang, idioms, and cliches. * Avoid slang, idioms, and cliches.
* Avoid unnecessary abbreviations. * Avoid unnecessary abbreviations.
@ -119,7 +119,7 @@ Agarics voice is:
Agarics tone is usually informal, but its always more important to be clear than entertaining. When youre writing, consider the readers state of mind. Are they curious about a post on our blog? Are they distrustful after being burned by a previous vendor? Are they excited to be engaging in a redesign? Once you have an idea of their emotional state, you can adjust your tone accordingly. Agarics tone is usually informal, but its always more important to be clear than entertaining. When youre writing, consider the readers state of mind. Are they curious about a post on our blog? Are they distrustful after being burned by a previous vendor? Are they excited to be engaging in a redesign? Once you have an idea of their emotional state, you can adjust your tone accordingly.
Agaric has a sense of humor, so feel free to be funny when its appropriate and when it comes naturally to you. If in any doubt, don not make the joke. Generally avoid humor in written communication to clients. Agaric has a sense of humor, so feel free to be funny when it is appropriate and when it comes naturally to you. If in any doubt, do not make the joke. Generally avoid humor in written communication to clients.
#### Running gags #### Running gags
@ -153,7 +153,7 @@ Dont refer to people using age-related descriptors like “young,” “old,
### Ability ### Ability
Dont refer to a persons ability unless its relevant to what youre 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, dont use the words “suffer,” “victim,” or “handicapped.” “Handicapped parking” is OK. Avoid using ableist language whenever possible. Dont refer to a persons ability unless its relevant to what youre 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, do not use the words “suffer,” “victim,” or “handicapped.” “Handicapped parking” is OK. Avoid using ableist language whenever possible.
### Gender and sexuality ### Gender and sexuality
@ -228,7 +228,7 @@ Second use: NOC
First use: Coordinated Universal Time (UTC) First use: Coordinated Universal Time (UTC)
Second use: UTC Second use: UTC
If the abbreviation or acronym is well known to your full intended audience, like API or HTML in technical documentation, use it instead (and dont worry about spelling it out). If the abbreviation or acronym is well known to your full intended audience, like API or HTML in technical documentation, use it instead (and do not worry about spelling it out).
#### Active voice #### Active voice