usds / playbook

The Digital Services Playbook
https://playbook.cio.gov/
1.42k stars 330 forks source link

Broken link, outdated name in Play 3: Make it simple and intuitive #232

Open christianmartine opened 4 years ago

christianmartine commented 4 years ago

Problem

In Play 3: Make it simple and intuitive, item 1 of the checklist states:

Use a simple and flexible design style guide for the service. Use the [U.S. Web Design Standards](https://playbook.cio.gov/designstandards) as a default
  1. The URL https://playbook.cio.gov/designstandards redirects to https://standards.usa.gov/ and then onward to https://designsystem.digital.gov. This process takes about 1 second longer with standards.usa.gov in the mix.
  2. The U.S Web Design Standards now appears to be called U.S. Web Design System and is located here: https://designsystem.digital.gov/.

Impact

People who try to access the link above through the Digital Services Playbook or who link to https://playbook.cio.gov/designstandards (like 18F does here will need to bear an additional load time of 1s (or more based on their internet speed). Separately, correcting the name will help people avoid confusion.

Proposed Solutions

  1. Change the redirect on https://playbook.cio.gov/designstandards from https://standards.usa.gov/ to https://designsystem.digital.gov/. This may reduce redirect time by 1s or more.
  2. In Play 3, update reference of U.S. Web Design Standards to U.S. Web Design System (addressed in pull request #233).

Additional Notes

  1. 18F/dns#418 addressed a problem called out earlier in this ticket where standards.usa.gov failed to redirect at all. It would still be worth updating the USDS redirect to remove the dependency on standards.usa.gov.
  2. It appears that playbook.cio.gov/designstandards is used in part to track usage with Google Analytics. The U.S. Web Design System is linked to directly at the bottom of https://www.usds.gov/. Choosing to link directly in Play 3 to designsystem.digital.gov would cut a full 2.6s+ off of the redirect.
afeld commented 4 years ago

Redirect is now in place.