diff --git a/_pages/examples/awards/index.md b/_pages/examples/awards/index.md index cc8e88a2..facabc18 100644 --- a/_pages/examples/awards/index.md +++ b/_pages/examples/awards/index.md @@ -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 + diff --git a/_pages/resources/checklists/index.md b/_pages/resources/checklists/index.md index d45dfae7..a662e77a 100644 --- a/_pages/resources/checklists/index.md +++ b/_pages/resources/checklists/index.md @@ -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 diff --git a/_pages/training/tips-for-trainers.md b/_pages/training/tips-for-trainers.md index 3eea3b32..e0f7f0f6 100644 --- a/_pages/training/tips-for-trainers.md +++ b/_pages/training/tips-for-trainers.md @@ -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. diff --git a/package-lock.json b/package-lock.json index 6e3d2365..235a8540 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15,7 +15,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", @@ -2033,24 +2033,6 @@ "node": ">= 8" } }, - "node_modules/@types/eslint": { - "version": "8.4.1", - "resolved": "https://registry.npmjs.org/@types/eslint/-/eslint-8.4.1.tgz", - "integrity": "sha512-GE44+DNEyxxh2Kc6ro/VkIj+9ma0pO0bwv9+uHSyBrikYOHr8zYcdPvnBOp1aw8s+CjRvuSx7CyWqRrNFQ59mA==", - "dependencies": { - "@types/estree": "*", - "@types/json-schema": "*" - } - }, - "node_modules/@types/eslint-scope": { - "version": "3.7.3", - "resolved": "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.3.tgz", - "integrity": "sha512-PB3ldyrcnAicT35TWPs5IcwKD8S333HMaa2VVv4+wdvebJkjWuW/xESoB8IwRcog8HYVYamb1g/R31Qv5Bx03g==", - "dependencies": { - "@types/eslint": "*", - "@types/estree": "*" - } - }, "node_modules/@types/estree": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.5.tgz", @@ -3073,9 +3055,9 @@ } }, "node_modules/enhanced-resolve": { - "version": "5.17.0", - "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.0.tgz", - "integrity": "sha512-dwDPwZL0dmye8Txp2gzFmA6sxALaSvdRDjPH0viLcKrtlOL3tw62nWWweVD1SdILDTJrbrL6tdWVN58Wo6U3eA==", + "version": "5.17.1", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.1.tgz", + "integrity": "sha512-LMHl3dXhTcfv8gM4kEzIUeTQ+7fpdA0l2tUf34BddXPkz2A5xJ5L/Pchd5BL6rdccM9QGvu0sWZzK1Z1t4wwyg==", "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.2.0" @@ -5939,11 +5921,10 @@ "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==" }, "node_modules/webpack": { - "version": "5.93.0", - "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.93.0.tgz", - "integrity": "sha512-Y0m5oEY1LRuwly578VqluorkXbvXKh7U3rLoQCEO04M97ScRr44afGVkI0FQFsXzysk5OgFAxjZAb9rsGQVihA==", + "version": "5.94.0", + "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.94.0.tgz", + "integrity": "sha512-KcsGn50VT+06JH/iunZJedYGUJS5FGjow8wb9c0v5n1Om8O1g4L6LjtfxwlXIATopoQu+vOXXa7gYisWxCoPyg==", "dependencies": { - "@types/eslint-scope": "^3.7.3", "@types/estree": "^1.0.5", "@webassemblyjs/ast": "^1.12.1", "@webassemblyjs/wasm-edit": "^1.12.1", @@ -5952,7 +5933,7 @@ "acorn-import-attributes": "^1.9.5", "browserslist": "^4.21.10", "chrome-trace-event": "^1.0.2", - "enhanced-resolve": "^5.17.0", + "enhanced-resolve": "^5.17.1", "es-module-lexer": "^1.2.1", "eslint-scope": "5.1.1", "events": "^3.2.0", diff --git a/package.json b/package.json index 677c962d..ebdf9ff1 100644 --- a/package.json +++ b/package.json @@ -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",