Skip to content

Commit

Permalink
Merge branch 'main' into dependabot/bundler/rexml-3.3.6
Browse files Browse the repository at this point in the history
  • Loading branch information
nick-mon1 authored Oct 1, 2024
2 parents 3be7dae + 5c341f2 commit bb1b950
Show file tree
Hide file tree
Showing 5 changed files with 16 additions and 34 deletions.
3 changes: 1 addition & 2 deletions _pages/examples/awards/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,5 +38,4 @@ Read Gore's [announcement speech]({{ site.baseurl }}/examples/awards/gore-speech
* [Award 11]({{ site.baseurl }}/examples/awards/award-11/): Dan Clem, NASA
* [Award 12]({{ site.baseurl }}/examples/awards/award-12/): Marlene Pegg and Maruita Bontz, Social Security Administration
* [Award 13]({{ site.baseurl }}/examples/awards/award-13/): Sharon L. Natanblut, Food and Drug Administration
* [Award 14](https://one.nhtsa.gov/nhtsa/announce/press/1999/pr030599.html): Mary Versailles and Nicole Fredette, National Highway Traffic Safety Administration
* [Award 15](https://www.gpo.gov/fdsys/pkg/FR-1999-08-02/pdf/99-19584.pdf): Farm Credit Administration

2 changes: 1 addition & 1 deletion _pages/resources/checklists/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ sidenav: resources

* [Checklist for Plain Language](/resources/checklists/checklist/), PLAIN
* [Checklist for Plain Language on the Web](/resources/checklists/web-checklist/), PLAIN
* [10 Steps to Plain Writing](https://www.census.gov/content/dam/Census/about/about-the-bureau/policies_and_notices/10_simple_steps.pdf) (PDF), Census
* [10 Steps to Plain Writing](https://web.archive.org/web/20170601202706/https://www.census.gov/content/dam/Census/about/about-the-bureau/policies_and_notices/10_simple_steps.pdf) (PDF), Census
* [Quick Checklist for Plain Language](https://www.slideshare.net/PlainTalkConf/jeanne-mcgee-and-the-center-for-health-literacy-quick-checklist-for-plain-language), Center for Health Literacy
* [Five Steps to Plain Language](http://centerforplainlanguage.org/learning-training/five-steps-plain-language/), Center for Plain Language
* [Plain Language Checklist for Documents](https://www.nala.ie/publications/a-plain-english-checklist-for-documents/), National Adult Literacy Agency
Expand Down
8 changes: 5 additions & 3 deletions _pages/training/tips-for-trainers.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,12 +36,14 @@ SMART goals are specific, measurable, achievable, realistic, and have a timefram

## Follow plain language guidelines

- [Have a topic sentence]({{ site.baseurl }}/guidelines/organize/have-a-topic-sentence/). In [First Things First: The Lost Art of Summarizing](http://aja.ncsc.dni.us/courtrv/cr38-2/CR38-2Kimble.pdf), Professor Joe Kimble emphasizes the importance of a good opening sentence.
There are some best practices to follow when writing with plain language. Below are a few to help you get started, and more can be found on [Federal plain language guidelines]({{ site.baseurl }}/guidelines/).

- [Use the active voice]({{ site.baseurl }}/guidelines/conversational/use-active-voice/). The European Commission's Translation Service is running a "Fight the Fog" campaign, which includes many online resources for improving writing. In its [Write Clearly](http://www.au.af.mil/au/awc/awcgate/eu/fight_the_fog_en.pdf) booklet, Fight the Fog gives tips on changing passive voice to active by naming the agent of an action.
- [Have a topic sentence]({{ site.baseurl }}/guidelines/organize/have-a-topic-sentence/). Good opening sentences help organize the structure of writing.

- [Organize the information]({{ site.baseurl }}/guidelines/organize/). In [Plain Language: A Handbook for Writers in the U.S. Federal Government](http://www.lauchmangroup.com/PDFfiles/PLHandbook.PDF), Richard Lauchman explains how to prepare the reader for what to expect by using summary statements, being precise on the subject lines of letters and email messages, and summarizing lengthy documents in one, up-front paragraph.
- [Use the active voice]({{ site.baseurl }}/guidelines/conversational/use-active-voice/). Active voice helps the message stay clear and easy-to-read.

- [Organize the information]({{ site.baseurl }}/guidelines/organize/). Prepare readers for what to expect by summarizing lengthy documents up-front and being precise on the subject lines of letters and email messages.

- [Use tables]({{ site.baseurl }}/guidelines/design/use-tables-to-make-complex-material-easier-to-understand/). You can use tables effectively for much more than just showing numerical data.

- [Use lists]({{ site.baseurl }}/guidelines/organize/use-lists/). Using lists instead of traditional paragraphs can help you convey detailed information quickly without overloading your readers.
35 changes: 8 additions & 27 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
"basscss-sass": "^4.0.0",
"glob-parent": "^6.0.2",
"pa11y-ci": "^2.4.2",
"webpack": "^5.93.0"
"webpack": "^5.94.0"
},
"devDependencies": {
"@18f/identity-stylelint-config": "^1.0.0",
Expand Down

0 comments on commit bb1b950

Please sign in to comment.