Visitar URL original
USWDS: Draft 3.11.0 release notes · Issue #6221 · uswds/uswds · GitHub
Skip to content

USWDS: Draft 3.11.0 release notes #6221

Closed
Task
Closed
USWDS: Draft 3.11.0 release notes#6221
Task
Assignees
amyleadem
Milestone
uswds 3.11.0 - Dec 2024

Description

@amyleadem
amyleadem
opened on Nov 21, 2024

Summary

Draft release notes for USWDS 3.11.0 based on this template (Google Docs 🔒).

Activity

  1. amyleadem
    moved this to Needs refinement in USWDS Core Project Dataon Nov 21, 2024
  2. amyleadem
    added this to USWDS Core Project Dataon Nov 21, 2024
  3. amyleadem
    self-assigned this
    on Nov 21, 2024
  4. amyleadem
    added this to the USWDS release: December 2024 milestone on Nov 21, 2024
  5. github-actions
    added
    Status: Triage
    on Nov 21, 2024
  6. amyleadem
    removed
    Status: Triage
    on Nov 25, 2024
  7. amyleadem
    moved this from Needs refinement to In progress in USWDS Core Project Dataon Nov 29, 2024

  8. amyleadem commented on Nov 29, 2024

    @amyleadem
    amyleadem
    on Nov 29, 2024
    ContributorAuthor

    What's new in USWDS 3.11.0

    Features

    Package A11y Breaking Markup change Description
    usa-elements - - - Removed outdated browser normalization styles. This update drops normalize support for Internet Explorer. Thanks @aduth! (#5555)
    usa-form, usa-input-prefix-suffix, usa-input, uswds-core - - - Moved .usa-input--[width] and .usa-input-group--[width] classes out of the usa-form package. These classes are now generated in the usa-input and usa-input-prefix-suffix packages and can be used without the .usa-form parent element. Thanks @aduth! (#6232)
    usa-table - - - Updated table header styles to be consistent across all table elements. Now, all thead th, tbody th, and tfoot th cells will all have the same visual styles. Thanks @ajanickiv!

    ✏️ Teams should confirm that their tables display as expected. (#5986)

    Bug fixes

    Package A11y Breaking Markup change Description
    usa-button, usa-collection, usa-file-input, usa-icon-list, usa-icon, usa-input-prefix-suffix, usa-modal, usa-pagination - - Yes Replaced deprecated xlink:href references with href.

    ✏ Teams should update their markup to replace xlink:href references with href and pull in the updated loader.svg file. (#6165)
    usa-file-input Yes - - Fixed a bug that prevented screen readers from announcing the invalid file type error message. (#6168)

    ✏️ Teams who support additional languages should update the error message string to match the new copy.
    usa-footer Yes - - Removed overflow: hidden from usa-footer to allow the full focus outline to show. This fix also improves horizontal alignment in the slim footer variant. Thanks @6TELOIV! (#6237)

    Markup changes

    MDN warns that the deprecated xlink:href attribute can stop working at any time. When referencing SVG icon sprites, teams should use href instead of the deprecated xlink:href attribute.

    <!-- usa-icon example -->
<svg class="usa-icon" aria-hidden="true" focusable="false" role="img">
- <use xlink:href="./img/sprite.svg#close"></use>
+ <use href="./img/sprite.svg#close"></use>
</svg>

    Dependencies and security

    Dependency name Previous version New version
    @babel/core 7.25.7 7.26.0
    @babel/preset-env 7.25.7 7.26.0
    axe-core 4.10.0 4.10.2
    cross-spawn 7.0.3 7.0.6
    html-webpack-plugin 5.6.0 5.6.3
    mocha 10.7.3 10.8.2
    nwsapi (added via npm overrides) -- 2.2.13
    postcss 8.4.47 8.4.49
    prettier 3.3.3 3.4.2
    sass 1.79.4 1.83.0
    sass-embedded 1.79.4 1.83.0
    snyk 1.1293.1 1.1294.3
    stylelint 16.9.0 16.11.0
    typescript 5.6.2 5.7.2
    webpack 5.95.0 5.97.1

    N vulnerabilities in regular dependencies (dependencies for USWDS projects installed with npm install @uswds/uswds)
    29 moderate, 26 high vulnerabilities in devDependencies (development dependencies).

    Release TGZ SHA-256 hash: 1c10cd70a3c627fd14d9ee74a4071e67c4e5ba4bf14ca1c50c19c2fe5885e70a

  9. amyleadem
    moved this from In progress to Review in USWDS Core Project Dataon Dec 13, 2024

  10. mahoneycm commented on Dec 13, 2024

    @mahoneycm
    mahoneycm
    on Dec 13, 2024
    Contributor

    @amyleadem for the xlink:href are we only listing packages with markup changes? Or should we list all affected packages (for example, button and file input)

  11. mahoneycm commented on Dec 13, 2024

    @mahoneycm
    mahoneycm
    on Dec 13, 2024
    Contributor

    Also heads up, we're working on a dependency update PR right now. I'll compare and update the dependency table once that is up 👍

  12. mahoneycm commented on Dec 13, 2024

    @mahoneycm
    mahoneycm
    on Dec 13, 2024
    Contributor

    question: For the xlink:href, should we add a note for users to recommend removing as well?

    If so:

    Suggestion: ✏ Teams should remove this deprecated attribute from their components as well

  13. amyleadem commented on Dec 17, 2024

    @amyleadem
    amyleadem
    on Dec 17, 2024
    ContributorAuthor

    question: For the xlink:href, should we add a note for users to recommend removing as well?

    If so:

    Suggestion: ✏ Teams should remove this deprecated attribute from their components as well

    @mahoneycm

    Interesting note! My initial thought was to say it is outside the scope of USWDS, but a note like this might help keep users aware that support might drop. What do you think of something like this?

    ✏ MDN warns that the deprecated xlink:href attribute can stop working at any time. Teams should update this attribute in their projects.

  14. mahoneycm commented on Dec 17, 2024

    @mahoneycm
    mahoneycm
    on Dec 17, 2024
    Contributor

    @amyleadem lgtm! Small optional suggestion would be to add that teams should "review their markup and update this attribute if needed" or something along those lines. Potentially unnecessary though!

  15. amyleadem commented on Dec 17, 2024

    @amyleadem
    amyleadem
    on Dec 17, 2024
    ContributorAuthor

    Made some updates:

  16. mahoneycm commented on Dec 17, 2024

    @mahoneycm
    mahoneycm
    on Dec 17, 2024
    Contributor

    Looks like the the final vulnerability count got added to the bottom of the dependency table. Other than that, lgtm!

    If we include dependency updates from #6255 and #6256 we should make sure to include these changes in the table.

  17. amyleadem commented on Dec 17, 2024

    @amyleadem
    amyleadem
    on Dec 17, 2024
    ContributorAuthor

    Update: added uswds-core to the package list for #6232

  18. amyleadem commented on Dec 17, 2024

    @amyleadem
    amyleadem
    on Dec 17, 2024
    ContributorAuthor

    Update: Added a line break to move the vulnerability section out of the dependency table

  19. mejiaj commented on Dec 17, 2024

    @mejiaj
    mejiaj
    on Dec 17, 2024
    Contributor

    Made some updates:

    @amyleadem re: bug vs feature: seems like a feature because nothing is currently broken.

    xlink for SVGs

    I like the idea of a note. If possible, it'd be helpful to have the generic note and an example of what that looks like in context of USWDS component.

    For example

    ✏ Teams should use `href` instead of `xlink:href` (deprecated) when referencing any SVG icon sprites, for example when using USA Icon.

    <!-- USA Icon example -->
<svg class="usa-icon" aria-hidden="true" focusable="false" role="img">
-  <use xlink:href="./img/sprite.svg#close"></use>
+  <use href="./img/sprite.svg#close"></use>
</svg>

  20. amyleadem commented on Dec 17, 2024

    @amyleadem
    amyleadem
    on Dec 17, 2024
    ContributorAuthor

    Realized I accidentally saved over some of my changes in the release notes (:doh:), so I restored the entry for #5555, added a markup changes section, and added a "teams should..." note for #6165.
    Let me know if you want any changes.

  21. mejiaj commented on Dec 17, 2024

    @mejiaj
    mejiaj
    on Dec 17, 2024
    Contributor

    LGTM

  22. amyleadem commented on Dec 17, 2024

    @amyleadem
    amyleadem
    on Dec 17, 2024
    ContributorAuthor

    Note: Need to update the dependency tables after POAM PRs are merged

  23. amyleadem
    moved this from Review to Fed Final Review in USWDS Core Project Dataon Dec 18, 2024

  24. thisisdano commented on Dec 18, 2024

    @thisisdano
    thisisdano
    on Dec 18, 2024
    Contributor

    Done!

  25. thisisdano
    closed this as completedon Dec 18, 2024
  26. github-project-automation
    moved this from Fed Final Review to Done in USWDS Core Project Dataon Dec 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Task

Projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions