Skip to content

trussworks/accessibility

Repository files navigation

Accessibility at Truss

This is the primary repository of information and resources surrounding accessibility practices at Truss.

Tracking work

Issues and their progress will be captured on the Github project board.

Guild

Discussion and support at #g-accessibility

Guide

What is accessibility?

Accessibility (also abbreviated as a11y) is making sure that a greater number of users are able to access and use your product.

Accessibility is inclusion

Accessibility is not just making sure that a web application is usable by those with physical limitations. While it is very important for those that rely on screen readers and other assistive devices to be able to use the application, other limiting factors can include: type of device, language, content, bandwidth, etc. Ideally we wish to include as many different types of users and situations to be able to access our application as realistically as we can.

Government compliance

All federal web applications have accessibility requirements (typically written into contracts) which may also apply at the state and city level. Common thresholds for compliance include 508 and WCAG 2.1 AA.

Commercial compliance

While not commonly required, we should also be aware of why accessibility can be important for commercial applications as well. Commercial applications may be subject to legal, legislative, reputation, and/or ethical reasons to follow accessibility guidelines.

Accessibility is important during the entire project lifecycle

Accessibility needs to be incorporated throughout the entire lifecycle of a project, it should not be incorporated as an afterthought or checked only towards the end. It is much easier to address issues during feature conception, development, and story creation phases; as a consequence, it will save time and therefore become more cost effective for the project.

Accessibility is important across practices

Every role in the project should be aware of the importance of accessibility and have a basic understanding of how they are addressed (even if they only know to look at this guide as a reference first). Accessibility should not be beholden to only one practice to address (e.g. just engineers to fix tags or designers to figure out color and content), but it should be the shared responsibility of everyone on the project. An effective team can work together to make sure that accessibility concerns are met throughout the entire project lifecycle.

Processes for teams

For accessibility to be integrated into our agile, iterative practices, teams need to establish agreed-upon processes.

Wiki

You can use the wiki to find tips and recommendations on how to make your website accessible. This covers a range of topics including various form elements, patterns, implementation suggestions with rationale, examples and resources.

About

a11y resources and guild work

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published