CMS Phone number audit

[laflannery]

Description

We want to do an audit of phone numbers in rich text editors to see which are not following the VA content guidelines.

Update

As of 12/1 it's been decided that the aria-label attribute is not going to be required in phone numbers going forward. The reasoning for this:

• Pronunciation should not be forced. By using the aria-label attribute, we are forcing screen readers to pronounce the phone numbers how we think users want them to be read.
• There are multiple articles and research supporting the idea that aria-label is not needed in this instance
• Adding an aria-label to phone numbers is not convention, meaning that this behavior is not expected for all phone numbers across all sites throughout the web, but rather the opposite. Screen reader users expected to NOT have the attribute and expect the default behavior.

Next steps

• Confirm the assumption/change with BVA at the next monthly meeting on 12/13
• Figure out change management since editors (Especially the VAMC editors) have consistently been told that this is how they need to add phone numbers
  • Remove KB article for phone numbers
• Work with Platform to update existing guidelines
  • VA content style guidelines
  • <va-telephone> DS component
• This ticket/audit can be done but it should be done with the future guidelines in mind

Acceptance Criteria

• Audit is completed
• Audit is able to determine which phone numbers do have aria-labels and will therefore need to be removed
• Audit is able to determine which phone numbers do not have proper formatting and will need to be updated

Team

Please check the team(s) that will do this work.

• CMS Team
• Public Websites
• Facilities
• User support