Skip to content

Update Identifier Accessibility Statement link text guidance#2097

Merged
thisisdano merged 6 commits into
release-3.5.0from
dw-identifier-accessibility
May 26, 2023
Merged

Update Identifier Accessibility Statement link text guidance#2097
thisisdano merged 6 commits into
release-3.5.0from
dw-identifier-accessibility

Conversation

@thisisdano

@thisisdano thisisdano commented May 10, 2023

Copy link
Copy Markdown
Contributor

Summary

Updated Accessibility statement link text guidance. Updated the Identifier guidance to use the text "Accessibility statement" for the required link to an accessibility statement. We improved the supporting links that describe accessibility statements.

Related issue

Closes uswds/uswds#5092

Preview link

Preview link

Problem statement

We'd like to support teams adding Accessibility statement links to their sites. Our existing guidance is a little bit ambiguous (pointing to "parent agency"), and we can clear it up by saying that these links should point to "your website or service's accessibility statement, or to your agency's accessibility statement if your website or service does not have its own." We should link to Section 508's accessibility statement guidance, and point to a good example of an accessibility statement, like the one on DHS.gov.

Testing and review

  1. Read the Accessibility statement guidance on the Identifier's component page.
  2. Check for grammar and sense.
  3. Assure that the accessibility statement link goes to Section 508's accessibility statement guidance (https://www.section508.gov/manage/laws-and-policies/website-accessibility-statement/).
  4. Assure that the example link goes to the DHS accessibility page (https://www.dhs.gov/accessibility).
  5. Check the changelog entries to assure that they are clear and correct, and link to the proper PRs.

This Identifier item is meant to link to an agency's accessibility statement.

Not every website has a parent agency, sometimes it's the agency itself. It's more clear to simply say "agency".
Link to your website or service's accessibility statement, if you have one, otherwise like to your agency's accessibility statement.
@thisisdano
thisisdano marked this pull request as ready for review May 26, 2023 16:44
@thisisdano

thisisdano commented May 26, 2023

Copy link
Copy Markdown
Contributor Author

This will fail in Circle because of broken links to the USWDS 3.5.0 release in the changelog.

Comment thread _data/changelogs/component-identifier.yml Outdated
@thisisdano
thisisdano merged commit 771bb9e into release-3.5.0 May 26, 2023
@thisisdano
thisisdano deleted the dw-identifier-accessibility branch May 26, 2023 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants