From 2308ee6304231a7483a3beea4741b4b04b35d305 Mon Sep 17 00:00:00 2001 From: rachidatecs Date: Wed, 26 Jul 2023 15:53:33 -0400 Subject: [PATCH] Document ANDI usage for accessibility testing --- docs/developer/README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/developer/README.md b/docs/developer/README.md index bc102a64b..b5c993ad3 100644 --- a/docs/developer/README.md +++ b/docs/developer/README.md @@ -166,6 +166,16 @@ from .common import less_console_noise # ``` +### Accessibility Testing in the browser + +We use the [ANDI](https://www.ssa.gov/accessibility/andi/help/install.html) browser extension +from ssa.gov for accessibility testing outside the pipeline. + +ANDI will get blocked by our CSP settings, so you will need to install the +[Disable Content-Security-Policy extension](https://chrome.google.com/webstore/detail/disable-content-security/ieelmcmcagommplceebfedjlakkhpden) and activate it for the page you'd like +to test. + + ### Accessibility Scanning The tool `pa11y-ci` is used to scan pages for compliance with a set of @@ -203,7 +213,7 @@ Assets are stored in `registrar/assets` during development and served from `regi We utilize the [uswds-compile tool](https://designsystem.digital.gov/documentation/getting-started/developers/phase-two-compile/) from USWDS to compile and package USWDS assets. -## Making and view style changes +## Making and viewing style changes When you run `docker-compose up` the `node` service in the container will begin to watch for changes in the `registrar/assets` folder, and will recompile once any changes are made.