Content Guidelines - grammar

[emmathrash]

Overview

Updating the Content Guidelines. Content needs to create a section dedicated to grammar e.g. when and where to use contractions, american spelling, relevant acronyms etc.

Action Items

• [ ] Consider, research options for existing grammar guidelines and best practices, look for other examples
• [ ] Consider existing grammar rules (there is not one section, much of it is in the chart, which is a template from "the bird book" by Torrey P.)
• [x] Open discussion with content team about which one, if any, best suits the EA content guideline needs, and where it fits best within the Guidelines
• [ ] Write a section dedicated to grammar rules for all content
• [ ] Don't forget to add all relevant resources to the resource section
• [ ] Reach out for feedback from the Team
• [ ] Iterate solutions, presenting at Content meetings for feedback
• [ ] Finalize a solution, add label ready for content lead.

Resources/Notes

Add links to workspace for this issue (i.e. Content Guideline page), and any relevant resources for this work https://www.stylemanual.gov.au/grammar-punctuation-and-conventions/shortened-words-and-phrases/contractions#shorten_single_words_and_grammatical_phrases_with_care https://medium.com/@joanne.schofield/using-contractions-could-be-making-your-writing-inaccessible-4034bb3cd76a https://medium.com/@xupeilan05/i-or-you-exploring-the-use-of-person-in-content-design-e6502a376dd2 https://apnews.com/article/archive-race-and-ethnicity-9105661462 https://www.sjsu.edu/writingcenter/docs/handouts/AP%20Style-2024.pdf

Spell check issue may be relevant here when it's created? - This is further down the line/we don't have a mechanism for it currently. When we do, this section should be updated to reflect practices.

[SamHyler]

@emmathrash Updated this one as well, let me know what you think

[emmathrash]

@SamHyler This one looks good! I say we move it on over.

[emmathrash]

Starting points: No exclamations Contractions aren't accessible When should we avoid personal pronouns? Best practices. Semi-colons shouldn't be necessary, but how long should sentences be? Punctuate all full sentences? Open to best practices on when to use punctuation here. Diction. Don't use abbreviations.

[github-actions[bot]]

Hey @cherylcline! Thanks for taking this issue.

To help keep everyone in the loop, please comment your Estimated Time to Completion (ETC) below!

Thanks again!

[github-actions[bot]]

Hey @cherylcline! Thanks again for taking this issue.

Time for an update! Please comment the following update:
**Progress:** What's the status of the project? What have you done and what still needs to be done?
**Estimated Time to Completion (ETC):** When do you estimate to be finished?
**Blockers:** Anything preventing you from finishing?

Thanks again!

[github-actions[bot]]

Hey @cherylcline! Thanks again for taking this issue.

Time for an update! Please comment the following update:
**Progress:** What's the status of the project? What have you done and what still needs to be done?
**Estimated Time to Completion (ETC):** When do you estimate to be finished?
**Blockers:** Anything preventing you from finishing?

Thanks again!

[github-actions[bot]]

Hey @cherylcline! Thanks again for taking this issue.

Time for an update! Please comment the following update:
**Progress:** What's the status of the project? What have you done and what still needs to be done?
**Estimated Time to Completion (ETC):** When do you estimate to be finished?
**Blockers:** Anything preventing you from finishing?

Thanks again!