Add Figma v2.0 changelog to the website (#2653)

jorytindall · web-flow · commit c4b114f4d80c · 2025-02-13T08:39:04.000-08:00
diff --git a/packages/components/CHANGELOG-FIGMA-COMPONENTS.md b/packages/components/CHANGELOG-FIGMA-COMPONENTS.md
@@ -1,20 +1,32 @@
-# [HDS Components UI Kit](https://www.figma.com/design/iweq3r2Pi8xiJfD9e6lOhF/HDS-Components-v2.0?m=auto&node-id=2-7&t=YeAupEyKdQqauO1k-1)
-
-## January 23rd, 2025
-
-`Advanced Table` - Added new component.
-`Code Editor` - Added new component.
-`Table` - Added column borders.
+# [HDS Components UI Kit v2.0](https://www.figma.com/design/iweq3r2Pi8xiJfD9e6lOhF/HDS-Components-v2.0?m=auto&node-id=2-7&t=HYGTIoXBy2YkVWDP-1)
 
 ## December 20th, 2024
 
 `IconTile` - Removed the border and updated the colors for improved contrast and to create a distinctive look that aligns better with the surrounding elements.
 
-**Deprecated** HDS Components UI Kit v1.0. It will no longer receive updates or support. 
+`SideNav` - No longer deprecated due to adjustments in prioritization.
 
-Released HDS Components UI Kit v2.0.
+### Figma v2.0 Components
 
-`SideNav` - No longer deprecated due to adjustments in prioritization.
+- Deprecated HDS Components UI Kit v1.0. It will no longer receive updates or support.
+- Released HDS components UI Kit v2.0.
+
+In many cases, replacing v1.0 library components with the components in the Figma v2.0 Library will result in breaking changes. For a comprehensive list of how these changes will impact your designs, refer to the [changelog document](https://docs.google.com/document/d/1q9IGtrsVOf3KrSBGb8AdF3OhPUm3fYAwPdhSml7onMM/edit?tab=t.0#heading=h.15f60fqiivvr).
+
+#### General changes
+
+- Improved consistency in component naming conventions
+- Enhanced property panel customization options
+- Reduced variant complexity through boolean properties
+- Added local tokens for custom styling (hidden from publishing)
+- Standardized nested component structure
+
+#### Component organization updates
+
+- Standardized naming conventions, nested structures, and boolean property usage to reduce complexity.
+- Updated organization with "Form /" prefixes and DialogPrimitive as the base for modal components.
+- Introduced [Template] components for common combinations.
+- Improved nested component accessibility for easier customization.
 
 ## September 11th, 2024
 
diff --git a/packages/components/CHANGELOG-FIGMA-FOUNDATIONS.md b/packages/components/CHANGELOG-FIGMA-FOUNDATIONS.md
@@ -1,4 +1,11 @@
-# [HDS Foundations UI Kit](https://www.figma.com/design/uX4OEaJQdWfzULADchjAeN/HDS-Foundations-v2.0?m=auto&node-id=2916-4&t=vnWfSubCHQU6J1U3-1)
+# [HDS Foundations UI Kit v2.0](https://www.figma.com/design/uX4OEaJQdWfzULADchjAeN/HDS-Foundations-v2.0?m=auto&node-id=2916-4&t=vnWfSubCHQU6J1U3-1)
+
+## December 20th, 2024
+
+- Deprecated HDS Foundations UI Kit v1.0. It will no longer receive updates or support.
+- Released HDS Foundations UI Kit v2.0.
+
+Migrating Figma designs from the v1.0 library to the v2.0 library mainly requires replacing Figma Styles with Variables and is considered a breaking change. A comprehensive list of how these changes will impact your designs can be found in the [changelog document](https://docs.google.com/document/d/1q9IGtrsVOf3KrSBGb8AdF3OhPUm3fYAwPdhSml7onMM/edit?tab=t.0#heading=h.15f60fqiivvr).
 
 ## November 2nd, 2023
 
diff --git a/website/docs/whats-new/release-notes/partials/figma-library-components.md b/website/docs/whats-new/release-notes/partials/figma-library-components.md
@@ -8,27 +8,37 @@
 ## Components library
 
 <p class="doc-whats-new-changelog-figma-library">
-  <strong>Figma library: <a href="https://www.figma.com/design/iweq3r2Pi8xiJfD9e6lOhF/HDS-Components-v2.0?m=auto&node-id=2-7&t=YeAupEyKdQqauO1k-1" target="_blank" rel="noopener noreferrer">HDS Components UI Kit</a></strong>
+  <strong>Figma library: <a href="https://www.figma.com/design/iweq3r2Pi8xiJfD9e6lOhF/HDS-Components-v2.0?m=auto&node-id=2-7&t=HYGTIoXBy2YkVWDP-1" target="_blank" rel="noopener noreferrer">HDS Components UI Kit v2.0</a></strong>
 </p>
 
 
-### January 23rd, 2025
+### December 20th, 2024
 
-`Advanced Table` - Added new component.
+`IconTile` - Removed the border and updated the colors for improved contrast and to create a distinctive look that aligns better with the surrounding elements.
 
-`Code Editor` - Added new component.
+`SideNav` - No longer deprecated due to adjustments in prioritization.
 
-`Table` - Added column borders.
+#### Figma v2.0 Components
 
-### December 20th, 2024
+- Deprecated HDS Components UI Kit v1.0. It will no longer receive updates or support.
+- Released HDS components UI Kit v2.0.
 
-`IconTile` - Removed the border and updated the colors for improved contrast and to create a distinctive look that aligns better with the surrounding elements.
+In many cases, replacing v1.0 library components with the components in the Figma v2.0 Library will result in breaking changes. For a comprehensive list of how these changes will impact your designs, refer to the [changelog document](https://docs.google.com/document/d/1q9IGtrsVOf3KrSBGb8AdF3OhPUm3fYAwPdhSml7onMM/edit?tab=t.0#heading=h.15f60fqiivvr).
 
-**Deprecated** HDS Components UI Kit v1.0. It will no longer receive updates or support. 
+##### General changes
 
-Released HDS Components UI Kit v2.0.
+- Improved consistency in component naming conventions
+- Enhanced property panel customization options
+- Reduced variant complexity through boolean properties
+- Added local tokens for custom styling (hidden from publishing)
+- Standardized nested component structure
 
-`SideNav` - No longer deprecated due to adjustments in prioritization.
+##### Component organization updates
+
+- Standardized naming conventions, nested structures, and boolean property usage to reduce complexity.
+- Updated organization with "Form /" prefixes and DialogPrimitive as the base for modal components.
+- Introduced [Template] components for common combinations.
+- Improved nested component accessibility for easier customization.
 
 ### September 11th, 2024
 
@@ -99,6 +109,10 @@ _Adding support for a `Tooltip` and updates to the `Sort Button` result in a bre
 
 `IconTile` and `IconTile-Logo` - Added a new product variant for Vault Secrets.
 
+### August 17th, 2023
+
+`SideNav` - Changed the icon from `User` to `Help` in the first dropdown at the top of the `SideNav`.
+
 
 ---
 
diff --git a/website/docs/whats-new/release-notes/partials/figma-library-foundations.md b/website/docs/whats-new/release-notes/partials/figma-library-foundations.md
@@ -8,10 +8,17 @@
 ## Foundations library
 
 <p class="doc-whats-new-changelog-figma-library">
-  <strong>Figma library: <a href="https://www.figma.com/design/uX4OEaJQdWfzULADchjAeN/HDS-Foundations-v2.0?m=auto&node-id=2916-4&t=vnWfSubCHQU6J1U3-1" target="_blank" rel="noopener noreferrer">HDS Foundations UI Kit</a></strong>
+  <strong>Figma library: <a href="https://www.figma.com/design/uX4OEaJQdWfzULADchjAeN/HDS-Foundations-v2.0?m=auto&node-id=2916-4&t=vnWfSubCHQU6J1U3-1" target="_blank" rel="noopener noreferrer">HDS Foundations UI Kit v2.0</a></strong>
 </p>
 
 
+### December 20th, 2024
+
+- Deprecated HDS Foundations UI Kit v1.0. It will no longer receive updates or support.
+- Released HDS Foundations UI Kit v2.0.
+
+Migrating Figma designs from the v1.0 library to the v2.0 library mainly requires replacing Figma Styles with Variables and is considered a breaking change. A comprehensive list of how these changes will impact your designs can be found in the [changelog document](https://docs.google.com/document/d/1q9IGtrsVOf3KrSBGb8AdF3OhPUm3fYAwPdhSml7onMM/edit?tab=t.0#heading=h.15f60fqiivvr).
+
 ### November 2nd, 2023
 
 `Elevation / Mid` - Fixed style not being correctly published to consuming libraries.
