Skip to content

Commit

Permalink
Merge branch 'main' into bc-update-agency-acronym
Browse files Browse the repository at this point in the history
  • Loading branch information
ToniBonittoGSA authored Oct 1, 2024
2 parents 097c090 + 5c341f2 commit 7d52248
Show file tree
Hide file tree
Showing 9 changed files with 551 additions and 1,127 deletions.
1 change: 1 addition & 0 deletions .nvmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
lts/*
2 changes: 1 addition & 1 deletion _pages/about/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,6 @@ Chief, Engagements Branch

This site launched in 1994, and was redesigned in 2004 with volunteers from PLAIN and student work facilitated by [Thom Haller](http://onlinelibrary.wiley.com/doi/10.1002/bult.2006.1720320411/epdf).

In 2017, we partnered with [18F](https://18f.gsa.gov/) to redesign the site and make it more accessible in modern browsers. plainlanguage.gov is built with the [U.S. Web Design Standards](https://standards.usa.gov/) and is hosted on [Federalist](https://federalist.18f.gov/) by the [General Services Administration](https://www.gsa.gov/portal/category/25729).
In 2017, we partnered with [18F](https://18f.gsa.gov/) to redesign the site and make it more accessible in modern browsers. PlainLanguage.gov is built with the [U.S. Web Design System](https://designsystem.digital.gov/) and is hosted on [Pages](https://www.cloud.gov/pages/) by the [U.S. General Services Administration](https://www.gsa.gov/about-us/organization/federal-acquisition-service/technology-transformation-services).

We are continuing to improve the site and [welcome your feedback](mailto:{{ site.email }}).
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.
11 changes: 0 additions & 11 deletions assets/js/main.js
Original file line number Diff line number Diff line change
@@ -1,11 +0,0 @@
import $ from 'jquery';
import Stickyfill from 'stickyfilljs';

var elements = document.getElementsByClassName('sticky');
Stickyfill.add(elements);

var navHeight = function () {
$('.usa-layout-docs-sidenav').css('height', $('.usa-layout-docs-sidenav').height());
};

navHeight();
Loading

0 comments on commit 7d52248

Please sign in to comment.