uswds / uswds-site

USWDS website and documentation
https://designsystem.digital.gov
Other
183 stars 140 forks source link

USWDS-Site - Consolidate all "References" sections and place at the bottom of the 'Data visualizations' page #2732

Open jaclinec opened 6 days ago

jaclinec commented 6 days ago

During top tasks usability testing đź”’, participants came to the first "References" section on the Data visualizations component page and thought that it was the end of the page, so they missed content below it. They commented that seeing 'References' often makes them assume it's the end of the content.

We should consolidate all of the 'References' sections on that page and put them at the bottom of the page, just above the changelog.

Additional context

To give more context on how to prioritize the new issues and feature requests that came out of top task testing, here's the full list of issues divided into 3 buckets and in order of priority (though it is somewhat flexible):

Low lift recommendations:

Medium lift recommendations:

High lift recommendations:

mejiaj commented 5 days ago

Guidance available in _components/data-visualizations/data-visualizations.md

Next steps:

Consolidate references favoring markdown instead of HTML (if possible).