From fcee0b441b4a00adabd6f219ce25512617eb6ca0 Mon Sep 17 00:00:00 2001 From: Bonnie Cameron <96838068+bonnieAcameron@users.noreply.github.com> Date: Mon, 23 Sep 2024 14:32:54 -0400 Subject: [PATCH 1/5] Update tips-for-trainers.md --- _pages/training/tips-for-trainers.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/_pages/training/tips-for-trainers.md b/_pages/training/tips-for-trainers.md index 3eea3b32..35b1841d 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.basurl }} /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. From 591f40b6d985ab48185874542aed0294f494fd98 Mon Sep 17 00:00:00 2001 From: Bonnie Cameron <96838068+bonnieAcameron@users.noreply.github.com> Date: Mon, 23 Sep 2024 15:16:24 -0400 Subject: [PATCH 2/5] fix formatting --- _pages/training/tips-for-trainers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_pages/training/tips-for-trainers.md b/_pages/training/tips-for-trainers.md index 35b1841d..7f472c2b 100644 --- a/_pages/training/tips-for-trainers.md +++ b/_pages/training/tips-for-trainers.md @@ -36,7 +36,7 @@ SMART goals are specific, measurable, achievable, realistic, and have a timefram ## Follow plain language guidelines -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.basurl }} /guidelines/). +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.basurl }} /guidelines/). - [Have a topic sentence]({{ site.baseurl }}/guidelines/organize/have-a-topic-sentence/). Good opening sentences help organize the structure of writing. From ca80d156479bdb17f4b6ac93e8e937f5c8568f4d Mon Sep 17 00:00:00 2001 From: Bonnie Cameron <96838068+bonnieAcameron@users.noreply.github.com> Date: Mon, 23 Sep 2024 15:19:57 -0400 Subject: [PATCH 3/5] update link formatting --- _pages/training/tips-for-trainers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_pages/training/tips-for-trainers.md b/_pages/training/tips-for-trainers.md index 7f472c2b..13b8155b 100644 --- a/_pages/training/tips-for-trainers.md +++ b/_pages/training/tips-for-trainers.md @@ -36,7 +36,7 @@ SMART goals are specific, measurable, achievable, realistic, and have a timefram ## Follow plain language guidelines -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.basurl }} /guidelines/). +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.basurl }}/guidelines/). - [Have a topic sentence]({{ site.baseurl }}/guidelines/organize/have-a-topic-sentence/). Good opening sentences help organize the structure of writing. From af8883fc63096101b7e4fbb66c6dcad37c0aa968 Mon Sep 17 00:00:00 2001 From: Bonnie Cameron <96838068+bonnieAcameron@users.noreply.github.com> Date: Mon, 23 Sep 2024 15:22:31 -0400 Subject: [PATCH 4/5] format link --- _pages/training/tips-for-trainers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_pages/training/tips-for-trainers.md b/_pages/training/tips-for-trainers.md index 13b8155b..2118a5bc 100644 --- a/_pages/training/tips-for-trainers.md +++ b/_pages/training/tips-for-trainers.md @@ -36,7 +36,7 @@ SMART goals are specific, measurable, achievable, realistic, and have a timefram ## Follow plain language guidelines -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.basurl }}/guidelines/). +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](https://www.plainlanguage.gov/guidelines/). - [Have a topic sentence]({{ site.baseurl }}/guidelines/organize/have-a-topic-sentence/). Good opening sentences help organize the structure of writing. From 640400741502adcff65e748f38824f5ff04d1526 Mon Sep 17 00:00:00 2001 From: Bonnie Cameron <96838068+bonnieAcameron@users.noreply.github.com> Date: Mon, 23 Sep 2024 15:25:47 -0400 Subject: [PATCH 5/5] format link --- _pages/training/tips-for-trainers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_pages/training/tips-for-trainers.md b/_pages/training/tips-for-trainers.md index 2118a5bc..e0f7f0f6 100644 --- a/_pages/training/tips-for-trainers.md +++ b/_pages/training/tips-for-trainers.md @@ -36,7 +36,7 @@ SMART goals are specific, measurable, achievable, realistic, and have a timefram ## Follow plain language guidelines -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](https://www.plainlanguage.gov/guidelines/). +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/). - [Have a topic sentence]({{ site.baseurl }}/guidelines/organize/have-a-topic-sentence/). Good opening sentences help organize the structure of writing.