Skip to content

USWDS-Site: Add consolidated changelog to what's new page #3118

Open
amyleadem wants to merge 42 commits into
al-whats-new-updates-feature-branchfrom
al-whats-new-consolidated-changelog
Open

USWDS-Site: Add consolidated changelog to what's new page #3118
amyleadem wants to merge 42 commits into
al-whats-new-updates-feature-branchfrom
al-whats-new-consolidated-changelog

Conversation

@amyleadem
Copy link
Copy Markdown
Contributor

@amyleadem amyleadem commented Feb 19, 2025

Summary

Added a consolidated changelog to the What's new page. This allows design system users know what's changed across the design system.

Note

This PR updates the solution created in PR #3091. This PR:

Related issue

Closes #1829

Preview link

Problem statement

It's important that design system users know how the design system is changing. We have changelogs on individual pages, but there's currently no way to see all the changes in a single view.

There've been many changes to the design system in the last couple weeks, and we've recently added content change alerts to content affected by recent executive orders and policy guidance.

Solution

Add a view to the What's New page so design system users know what's changed across the design system.

This PR adds a consolidated changelog to our What's New page so design system users can better keep up to date with these changes. This new view will show the last 250 changes to the design system.

Major changes

  • Created a new consolidated changelog feed that pulls in data from all changelog files and sorts them in reverse chronological order
  • Added new "affects" tags: isAddition, isRemoval, affectsPageContent, affectsLinks and added these tags to appropriate changelog entries
  • Added "page" data for the consolidated changelog

Testing and review

  • Confirm the entries in the consolidated changelog are displaying the expected data
    • Confirm all changelog entries display the appropriate "page" name
  • Confirm the consolidated changelog is readable at all screen widths on both the what's new page and the USWDS changelog page
  • Confirm the new "affects" tags make sense, display appropriately, and have been added to the appropriate changelog entries
  • Confirm no regressions in the changelogs on other pages
  • Confirm that there is not a better alternative for setting the page title in each changelog entry
  • Confirm the updated README content is accurate

@amyleadem amyleadem changed the base branch from al-whats-new-updates-feature-branch to dw-whats-new-newsfeed February 19, 2025 16:09
@amyleadem amyleadem changed the base branch from dw-whats-new-newsfeed to al-whats-new-updates-feature-branch February 21, 2025 22:33
@amyleadem amyleadem linked an issue Feb 24, 2025 that may be closed by this pull request
Comment thread _data/changelogs/pattern-user-profile-pronouns.yml
Latest code, guidance, and content updates across the design system.

<div class="margin-top-2">
{% include consolidated-changelog-table.html hideTagsTablet=true %}
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note

Added hideTagsTablet here because the in-page nav on the what's new page makes the table too narrow to be readable at tablet widths. This hides all the "Affects" column at tablet widths but still shows the breaking tag in the description column. This matches the existing behavior in changelog-table.html.

On the changelog page, there is more room so the tags remain visible at all widths.

Co-authored-by: Amy Leadem <93996430+amyleadem@users.noreply.github.com>
@annepetersen annepetersen marked this pull request as ready for review January 5, 2026 17:02
@annepetersen annepetersen self-assigned this Feb 4, 2026
@annepetersen annepetersen added the Needs: Help Wanted We need help on this issue label Feb 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Help Wanted We need help on this issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

USWDS-Site - What's new: Prototype collected changelogs

4 participants