Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin initial commit Jul 1, 2018
data
documentation
public fix partial styles May 8, 2019
routes Fix the run-tests view May 19, 2019
scripts Change `test.at` to `test.results` to better describe the purpose of … Apr 5, 2019
src add and display rationale for assertions May 3, 2019
views Add results for the APG checkbox example and add data points to track… May 24, 2019
.gitignore
.travis.yml fix the script command Jul 6, 2018
CONTRIBUTING.md
FAQ.md Consider chrome as a core browser for JAWS and Firefox May 19, 2019
LICENSE
app.js Add a basic search function Jul 17, 2018
build.js Fix a bug that was causing tests that reference many features to brea… May 1, 2019
changelog.md
package-lock.json update libraries Feb 24, 2019
package.json update libraries Feb 24, 2019
readme.md
test.js Tests can contain multiple assertions from many features (#65) Apr 28, 2019

readme.md

Accessibility Supported

Status: prototype, awaiting feedback

accessibilitysupported.com

Install and run

  1. Install required node packages: npm ci
  2. Build data: npm run build
  3. Run tests: npm run test
  4. Serve: npm run start

While working and making changes to the project, you can do all of this in one command:

npm run build && npm run test && npm run start

Once the project is running, it should be available at 'http://localhost:3000'

Structure

This project is built on express js, and all data lives in json files in the data directory. These json files are processed during the build step and saved to the build directory.

  • tech - tech are different categories of technology (html, css, aria, svg, etc)
  • feature - features are specific features of a technology, such as elements, attributes, properties, etc.
  • tests - tests are specific test cases for a feature (or many features). Each feature should have at least one test that only tests that feature.

the data directory

These files are essentially slimmed down versions of the full json files that are made during the build step. Only known information is filled out. The build step will add all unknown data points. The hope is that it will be easier to edit and maintain the these minimal files.

accept a support point

The task of accepting a support point is done by a project maintainer that has full access to the repository and is familiar with git and GitHub.

Users can run tests for specific AT/Browser combinations (support point) and post their findings to a github issue. These findings should be verified by another user before being added to the repository.

Once a support point is verified, it is ready to be added to the repository. There is a script at scripts/sync-support-point.js that makes this a easy.

Step 1: sync the test json file from a github issue (or comment)

Run node scripts/sync-support-point.js --issue {issue number} to update the appropriate json file with the results that were found. This will take the results in the issue body.

Run node scripts/sync-support-point.js --comment {comment id} to accept the results in a comment ID. This might be needed if a difference was found during the verification step. You can get the comment ID from the URL that is generated when the time stamp is clicked for the specific comment on GitHub.

Step 2: Review and commit

Now you just need to make sure that everything was synced correctly. If you think it is ready, commit the change and push to a new branch on Github.

  1. make sure you are on the right branch: git checkout master
  2. make sure your clone is up to date: git pull origin master
  3. build the project and test: npm run build && npm run test
  4. (optional) manually verify that everything looks good npm run start
  5. commit the changes: git commit -m 'closes #{issue-number}'
  6. push the changes git push origin master
You can’t perform that action at this time.