USWDS-Site: Updating links per Design Principles audit

[finekatie]

Summary

After extensive audit of links to determine relevance of links, edits can be made to this page.

Important

This page does not have a changelog - one needs to be added

Related issue

Closes #3054 / #2573

Preview link

Design principles page

Problem statement

Resources linked throughout the Design Principles page were aging or no longer relevant.

Solution

UX, CS, A11y teams and feds to audit and analyze relevance and timeliness of links, update and add new as needed.

Related documents:
Audit
Page draft with edits

Testing and review

Need reviews to compare to the page draft make sure links work and content is clean and clear.

[jaclinec]

Finished my review and added my comments to the page draft since it's probably clearer there. There was one link in the draft that I didn't see in the preview (18F User Experience Guide — Research ), and I commented on 3 other links - one that I think we decided should be removed, one that was duplicative, and one where I wondered if there was a more up-to-date resource to link to.

[finekatie]

@jaclinec - I made updates per your comments in the draft. Please review when you are up to it.

[jaclinec]

@finekatie everything looks good now - thanks!

[finekatie]

I reviewed links to make sure nothing was broken due to recent policy changes. All looks good. @annepetersen and @thisisdano this is ready for FFR.

[finekatie]

@finekatie everything looks good now - thanks!
When you can - can you re-review? Thanks! @jaclinec !

[amycole501]

I read over and clicked all the links focusing on the a11y section. The only slight oddity is that when I click the plain language link I see a bunch of weird code (maybe tracking code?) in the URL

1.Try clicking the "learn about writing in plain language" link under "further reading" in the "embrace accessibility" section.

2. Then look at your browser bar to see the URL or see below:

https://www.plainlanguage.gov/?_gl=1*t39m7h*_ga*MTI1NTE2MTY5Ni4xNzM0NTQ2MDY0*_ga_HBYXWFP794*MTczNzY0NDA4Mi41LjEuMTczNzY0NjA4MS4wLjAuMA..

It didn't seem to do that on the other plain language link on the page. I also deleted that code and the URL works fine. So maybe just a weird glitch (?)

[jaclinec]

I just reviewed it and all looks good except 2 links at the end of the page, which are broken:

• Delivering Excellent, Equitable, and Secure Federal Services and Customer Experience [performance.gov]
• OMB Circular A-11 Section 280: Managing Customer Experience and Improving Service Delivery(PDF) [performance.gov]

[finekatie]

Note: More 404 errors occurring. Links being audited again and corrections will be made. Will resubmit this for review once updates made to the branch.

[amyleadem]

@finekatie
issue: Looks like this link is 404-ing now

[finekatie]

Hey @jaclinec , should we go back to the old one or remove entirely? https://www.performance.gov/cx/assets/files/a11_2021-FY22.pdf

[finekatie]

Discussed with Jacline. Removing version.

[finekatie]

Page is updated. Needs date for changelog when approved for publish. This is ready for review and handoff for FFR.

[amyleadem]

Looking good, just found a couple of possible small copy tweaks in the comments below.

• Confirm the code meets standards
• Confirm the branch is up to date and tests pass
• Confirm no regressions in content display
• Confirm copy updates match pre-existing conventions
• Confirm the changelog is present and accurate

Note that I did not compare the changes to the edit doc (let me know if you want me to do that)

[amyleadem]

LGTM from a engineering perspective!

[jaclinec]

Everything looks good to me! :)