GSA / plainlanguage.gov

A resource to help federal employees write in plain language and comply with the Plain Writing Act of 2010
https://www.plainlanguage.gov
Other
156 stars 77 forks source link
civic-tech government policy

plainlanguage.gov

This is the public repo for plainlanguage.gov, which is an online resource to help federal employees understand and comply with the Plain Writing Act of 2010. It represents a joint effort by the Plain Language Action and Information Network (PLAIN) and the General Services Administration Technology Transformation Services.

About the site

Before you start

You will need to have the following installed on your machine before following the commands below:

Basic setup

  1. Install Jekyll and Bundler: gem install bundler jekyll
  2. Install gem dependencies bundle install
  3. Install node dependencies npm install

Notes for basic setup:

Running the site locally

To run the site locally, from the project folder, run:

npm start

If all goes well, visit the site at http://localhost:4000.

Note that this method will rebuild the entire site every time you make a change to any file, however, the browser may need to be refreshed to see changes. If you want faster builds, you can use bundle exec jekyll incrementalserve, which comes with some caveats, notably only changed files will be rebuilt. This means if you change a data file, HTML pages that use that data file won't be updated. Also, bundle exec jekyll incrementalserve may require an additional gem install.

Accessibility tests

We follow the WCAG2AA standard, and one of the ways we check that we're following the right rules is through automated tools, like pa11y. For more info on the rules being tested checkout the pa11y wiki.

Running tests

To run a web accessibility test on digital.gov do the following:

  1. Install and run the site locally following the Running the site locally instructions above. Site must be running locally to perform the scan.
  1. In a separate terminal window, run npm run test:pa11y to initiate the accessibility checker.

Note: Accessibility testing configuration is located in the .pa11yci file.

Contributing

To provide feedback on plainlanguage.gov, follow this repository and open an issue in the repo.

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.