docs(release-highlights): Adds highlights for 6.2 release.

packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md

@@ -3,11 +3,194 @@ id: Release highlights
 title: Release highlights
 section: get-started
 ---
-
 import './get-started.css';
 import { Divider, Timestamp } from '@patternfly/react-core';
 
-<Timestamp>January 2024</Timestamp>
+<Timestamp date={new Date(2025, 2)}>March 2025</Timestamp>
+
+## PatternFly 6.2
+
+### Promoted package versions
+- patternfly/patternfly ([changelog](https://github.com/patternfly/patternfly/releases/tag/v6.2.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/patternfly)
+- patternfly/react ([changelog](https://github.com/patternfly/patternfly-react/releases/tag/v6.2.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-charts)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-code-editor)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-core)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-drag-drop)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/icons)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-styles)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-table)
+    - [patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-templates)
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-tokens)
+- PatternFly extensions 
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/chatbot) ([changelog](https://github.com/patternfly/chatbot/releases/tag/v2.2.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/quickstarts) ([changelog](https://github.com/patternfly/patternfly-quickstarts/releases/tag/v6.2.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-catalog-view-extension) ([changelog](https://github.com/patternfly/react-catalog-view/releases/tag/v6.1.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-component-groups) ([changelog](https://github.com/patternfly/react-component-groups/releases/tag/v6.2.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-log-viewer) ([changelog](https://github.com/patternfly/react-log-viewer/releases/tag/v6.1.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-topology) ([changelog](https://github.com/patternfly/react-topology/releases/tag/v6.2.0))
+    - [@patternfly/[email protected]](https://www.npmjs.com/package/@patternfly/react-user-feedback) ([changelog](https://github.com/patternfly/react-user-feedback/releases/tag/v6.1.0))
+
+### Website updates
+
+##### Bugs 
+- We adjusted the SVG download behavior for [PatternFly icons](/design-foundations/icons/#all-icons), to remove a wrapping `<span>` that prevented imports into some design tools.
+- We improved accessibility for the hover text of PatternFly logos in the website masthead and footer.
+- We fixed an issue across our demos where the PatternFly masthead logo was the wrong color. 
+- We removed the Design with Sketch page, since that information is no longer current. References to the old PatternFly Sketch library now point to the v5 archive site.
+- Charts: 
+    - We updated the [alerts timeline example](/charts/bar-chart#alerts-timeline) to center tooltips above their respective bar.
+    - We fixed a few issues in CodeSandbox chart examples, including adding missing Victory dependency, adding missing `ChartThemeColor` import, ensuring Victory packages are up to date.
+- [Clipboard copy](/components/clipboard-copy): We added a missing action tooltip in the [inline compact with additional action](/clipboard-copy/#inline-compact-with-additional-action) example.
+- [Tabs:](/components/tabs) 
+    - We added a missing [props table for `TabContentBody`](/components/tabs#tabcontentbody).
+    - We removed the independent tab content page and moved the content within [the tabs HTML documentation](/components/tabs#tab-content). 
+
+##### Features
+- We expanded the [PatternFly 6 upgrade guide](/get-started/upgrade) to include additional instructions that we've put together as products have been completing their migration.
+
+### Component updates
+
+#### Bugs 
+- [Button](/components/button): We updated the `aria-disabled` implementation so that it will only render when `true`. If it's `false` or `undefined`, it will not render on the element.
+    - **Note:** If you have any tests checking for `aria-disabled` to be `false`, or to match the `disabled` property, those tests should be updated.
+- [Clipboard copy](/components/clipboard-copy): We added the `string[]` type to `children`.
+- [Charts](/charts/about-charts): We fixed errors related to Victory 37.3.4. If you're using PatternFly 5, use [react-charts](https://www.npmjs.com/package/@patternfly/react-charts) v7.4.8 with Victory v37.3.4 or later.
+- [Code editor](/components/code-editor): 
+    - We updated `handleResize` to ensure that it properly adjusts with viewport changes.
+    - We removed extra padding around uploaded contents by changing the `pf-v6-c-code-editor__upload` class to only be used while users are hovering over the editor.
+- [Data list](/components/data-list): We removed `aria-labelledby` and `aria-selected`, to align with best practices for accessibility. 
+- [Description list](/components/description-list): Added support to allow the help text button popover to open via keyboard.
+- File upload:
+    - For both [simple file upload](/components/file-upload/simple-file-upload) and [multiple file upload](/components/file-upload/multiple-file-upload)), we updated the input content to be hidden, to fix accessibility problems with keyboard focus.
+    - For [the custom simple file upload](/components/file-upload/simple-file-upload#custom-file-upload), we added the `isBrowseButtonDisabled` prop to allow you to disable the browse button as needed.
+- [Form control:](/components/forms/form-control) 
+    - We added additional, missing theming variables.
+    - We fixed an overlay bug that appeared for controls with long labels.
+- [Masthead](/components/masthead): We corrected vertical centering.
+- [Menu](/components/menus/menu): We updated `<MenuItem>` so that a mouse can properly trigger a tooltip on `aria-disabled` items. We also fixed `<MenuItem>` tooltips in general, to allow their `onClick` behavior to be triggered as expected.
+- [Search input](/components/search-input): We updated `isAdvancedSearchOpen` to be `false` by default. This fixes an issue where `aria-expanded` was only applied when the state was updated by clicking the search open, rather than when the component first rendered.
+- [Select](/components/select): 
+    - We fixed scrolling for menus with grouped items.
+    - In the [select template](/components/menus/select/react-templates), we added support for custom keydown handling.
+- [Table](/components/table): We rewrote table's [column management](/components/table/react-demos#column-management) and [column management with draggable](/components/table/react-demos#column-management-with-draggable) features, to replace the use of the deprecated `<DragDrop>` component and update the demos accordingly.
+- [Text area](/components/forms/text-area): We added a missing modifier class that caused display issues when text areas were in focus. 
+- [Truncate](/components/truncate): Fixed a text-duplication bug that appeared for long, middle-truncated strings.
+
+#### Features 
+We added the following new features:
+
+- [Alert](/components/alert): We added opt-in micro animations to alert and alert groups via the new `hasAnimations` prop. Animations will be visible in PatternFly.org examples soon.
+    - **Note:** By default, alert animations are opt-in and will only apply to alerts within an alert group. Opting into animations could require test updates. To ensure your test pass, the quickest solution is to set `hasAnimations` to `false`. Additionally, when alerts are dynamically added to an alert group, you must ensure that new alerts are prepended to the alert group list, rather than appended to the end of it.
+- [Card:](/components/card) We added the new `hasHeaderWrap` prop to use when there are long strings or multiple items in card headers.
+- Charts: 
+    - [Line chart (ECharts):](/charts/line-chart/ECharts/) We added a new line chart, based on Apache ECharts, with multiple examples in the docs.
+    - [Sankey chart (ECharts):](/charts/sankey-chart/) We added a new sankey chart, based on Apache ECharts, with multiple examples in the docs.
+- [Clipboard copy:](/components/clipboard-copy) We added support for [truncation in the inline compact variant](/components/clipboard-copy#inline-compact-with-truncation).
+- [Data list:](/components/data-list) We added a tooltip to be displayed when the `wrap` of a `<DataListCell>` is set to `truncate` and the content is overflowing.
+- [Jump links](/components/jump-links): We added a new `shouldReplaceNavHistory` prop that enables you to replace the current state with clicked items, rather than pushing the new location onto the history.
+- [Label:](/components/label) We added the `isClickable` prop, to be used for [labels with custom render](/components/label#label-with-custom-render). This prop allows you to set the clickable modifier while the render prop is also used. 
+- [Navigation:](/components/navigation) We added micro animations, which add motion to navigation items as they expand and collapse.
+- [Notification badge:](/components/notification-badge) We added support for opt-in micro animations via the new `shouldNotify` prop. We also added a [notification badge "With animations" example](/components/notification-badge#with-animation), so that you can observe the animated behavior.
+- [Page:](/components/page) To improve the visibility of content, we removed page margins for small viewports.
+- [Progress:](/components/progress) To match other PatternFly 6 styles, we rounded out the corners of the progress bar.
+- Text area: We added a [non-resizable text area variant](/components/forms/text-area#not-resizable), by adding a "none" option for the `resizeOrientation` prop.
+- [Toolbar:](/components/toolbar) 
+    - We added the new `hasNoPadding` prop, which removes the toolbar's default padding. This is useful for toolbars in certain layouts that apply spacing between the toolbar and surrounding elements.
+    - We added the `rowWrap` prop, for `<ToolbarGroup>` and `<ToolbarItem>`.
+
+#### Other notable changes 
+- We removed the `@reach/router` dependency in patternfly-react, since it is no longer React 18 compatible. As a result, we replaced its use in a number of component examples/demos, including [button](/components/button#using-router-links), [label](/components/label#using-router-links), [masthead](/components/masthead#using-router-links), [menu](/components/menus/menu#using-router-links), and [page](/components/page/react-demos#context-selectorperspective-switcher-in-sidebar).
+
+### Extension updates 
+
+#### Catalog view 
+
+##### Bugs
+- We resolved console errors that occurred when read-only badges were passed to `<CardHeader>` via the `actions` prop.
+- We adjusted [vertical tab](/extensions/catalog-view/vertical-tabs) styles to remove the underline.
+
+#### ChatBot
+
+##### Bugs
+- We fixed the appearance of links in the sources card for Backstage consumers.
+- We removed the cancel button from the user feedback form, which was unnecessary due to the presence of a close button.
+- We made some styling adjustments to the `<MessageBar>` to assist with downstream implementations.
+- We made updates for general style consistency.
+
+##### Features 
+We added the following list of new ChatBot features:
+
+- [Inline drawer display mode](/patternfly-ai/chatbot/overview/demo/#inline-drawer-chatbot).
+- [Message feedback and thank-you cards](/patternfly-ai/chatbot/messages#message-feedback).
+- [Resizable function for the conversation history drawer](/patternfly-ai/chatbot/ui#resizable-drawer).
+- [Layout for comparing ChatBots](/patternfly-ai/chatbot/overview/demo#comparing-chatbots).
+- [Support for quick starts](/patternfly-ai/chatbot/messages#messages-with-quick-start-tiles).
+- [Global ChatBot setting menu](/patternfly-ai/chatbot/ui#settings). 
+- [Terms of use modal](/patternfly-ai/chatbot/ui#terms-of-use).
+- [Loading and error states for the conversation history](/patternfly-ai/chatbot/ui/#drawer-with-search-and-new-chat-button).
+- Clicked-state styles for [message actions](/patternfly-ai/chatbot/messages/#message-actions).
+- Active-state and selected-state styles for [quick responses](/patternfly-ai/chatbot/messages/#messages-with-quick-responses).
+- [Support for custom message content](/patternfly-ai/chatbot/messages#custom-message-content) via the `extraContent` prop. Refer to the docs and use this feature with caution. 
+- Additional message content types (as shown in the [bot messages](/patternfly-ai/chatbot/messages#bot-messages) example): 
+    - Inline error message.
+    - Block quotes.
+    - Headings.
+    - External links, with styling.
+    - Images.
+    - Tables.
+
+
+##### Other notable changes
+- We updated [the ChatBot design guidelines](/patternfly-ai/chatbot/overview/design-guidelines) to include guidance for new features, expand existing guidance, and add higher-level patterns for using ChatBots in your product.
+- We added [analytics examples and documentation](/patternfly-ai/chatbot/analytics) to provide general guidance on the implementation of analytics tracking.
+- We removed the "dompurify" external dependency requirement.
+- We updated `<Message>` to allow additional [rehype plugins](https://github.com/rehypejs/rehype) for further customization of Markdown parsing. 
+- We replaced the `<MessageBar>` component with a [PatternFly `<TextArea>` component](/components/forms/text-area). This led to the following type changes for `<MessageBarProps>`:
+  - For `onChange`:
+    - Before: `(event: React.ChangeEvent<HTMLDivElement>, value: string) => void;`
+     - After: `(event: React.ChangeEvent<HTMLTextAreaElement>, value: string | number) => void;`
+  - for `onSendMessage`:
+    - Before: `(message: string) => void;`
+    - After: `(message: string | number) => void;`
+
+#### Component groups
+
+##### Bugs 
+- We updated the [responsive actions](/component-groups/controls/responsive-actions) component to make a disabled state available for overflow menu items.
+- We fixed props in a number of components, to include support for `ReactNode` objects.
+
+##### Features 
+- We added a new [stale data warning component](/component-groups/status-and-state-indicators/stale-data-warning).
+- We added a text confirmation option to the [warning modal](/component-groups/error-communication/warning-modal#warning-modal-with-a-text-confirmation).
+
+#### Topology 
+
+##### Bugs
+- We updated dynamic context menus (menus whose options depend on asynchronous processes like API calls) to fix an issue that caused menus to open downward (instead of upward) when there wasn't enough screen space. 
+
+#### User feedback 
+
+##### Bugs
+- We made updates to ensure that CSS overrides take precedence over PatternFly's default styles.
+
+#### Quick starts
+
+##### Bugs
+- We fixed an issue where plain code fences weren't being transformed.
+- We reduced the spacing between the catalog page title and hint.
+- We've changed the markdown parser to one that's more actively being maintained.
+    - If you're supplying any custom markdown extensions please verify that they still work properly, as this is the area where bugs are most likely from this change.
+    - If you see issues with custom markdown extensions, or any other issues with markdown parsing after this change, please [raise an issue](https://github.com/patternfly/patternfly-quickstarts/issues).
+- We improved style scoping to avoid clashing with PatternFly styles.
+
+##### Features 
+- We added support for the ChatBot extension.
+
+<Divider />
+
+<Timestamp date={new Date(2025, 0)}>January 2025</Timestamp>
 
 ## PatternFly 6.1.1
 
@@ -20,7 +203,7 @@ As a quick follow up to our last release, this update publishes the new data vie
 
 <Divider />
 
-<Timestamp>December 2024</Timestamp>
+<Timestamp date={new Date(2024, 11)}>December 2024</Timestamp>
 
 ## PatternFly 6.1
 
@@ -96,7 +279,7 @@ We've continued to evolve our new ChatBot:
 
 <Divider />
 
-<Timestamp>October 2024</Timestamp>
+<Timestamp date={new Date(2024, 9)}>October 2024</Timestamp>
 
 ## PatternFly 6.0
 The official release of PatternFly 6 is here! It contains all of the previous features from our alpha and beta releases, but also adds everything described in these release highlights.
@@ -208,7 +391,7 @@ In addition to the previously mentioned documentation updates, we've made change
 
 <Divider />
 
-<Timestamp>August 2024</Timestamp>
+<Timestamp date={new Date(2024, 7)}>August 2024</Timestamp>
 
 ## PatternFly 6 beta
 We’re excited to share the next milestone in our journey to PatternFly 6–our beta release! This beta introduces more improvements and refinement, and contains all major PatternFly 6 features. 
@@ -290,7 +473,7 @@ We applied PatternFly 6 styles to the rest of our extensions. All have now been
 - Catalog view
 - Quickstarts
 
-Related design resources can also be found in [our PatternFly 6 Figma kit.](https://www.figma.com/@patternfly)
+Related design resources can also be found in [our PatternFly 6 Figma kit](https://www.figma.com/@patternfly).
 
 ### Bug fixes
 We fixed bugs that were reported throughout the alpha period including. We:
@@ -302,7 +485,7 @@ We fixed bugs that were reported throughout the alpha period including. We:
 
 <Divider />
 
-<Timestamp>June 2024</Timestamp>
+<Timestamp date={new Date(2024, 5)}>June 2024</Timestamp>
 
 ## PatternFly 6 alpha 
 
@@ -316,8 +499,8 @@ All of our components have a new look to match. As you use the alpha website, ta
 
 ### Design tokens 
 
-In order to support PatternFly 6, and any future visual theming capabilities, we have implemented a design token system for PatternFly. For more details and instructions on how to use tokens, you can refer to our new [design token documentation.](/tokens/about-tokens)
+In order to support PatternFly 6, and any future visual theming capabilities, we have implemented a design token system for PatternFly. For more details and instructions on how to use tokens, you can refer to our new [design token documentation](/tokens/about-tokens).
 
 Our tokens cover both dark and light themes, and make it easier to support both in your product. We also updated our [dark theme handbook](/developer-resources/dark-theme-handbook) to align with our tokens.
 
-**Note:** The PatternFly 5 design library is not built with tokens. To take advantage of our token system, you must [upgrade your product to PatternFly 6.](/get-started/upgrade)
+**Note:** The PatternFly 5 design library is not built with tokens. To take advantage of our token system, you must [upgrade your product to PatternFly 6](/get-started/upgrade).