Skip to content

Commit c79f36c

Browse files
authored
docs(release-highlights): Adds highlights for 6.2 release. (#4493)
* docs(release-highlights): Adds highlights for 6.2 release. * couple typos * Expands on chatbot updates and reorganizes some * Remove chatbot line * Adds notes from closed React issues. * Apply suggestions from code review * Update a few component notes. * Update with recently completed core and react issues. * Adds more notes and changes timestamps. * Adjust timestamps. * A couple of edits * Add preliminary package list. * Update packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md * ChatBot design guidelines pr merged * Update animation line * Re-craft highlights into a few narratives. * Change timestamp for 6.2. * Change details for nav animation. * Some phrasing changes.
1 parent d73cb66 commit c79f36c

File tree

1 file changed

+125
-11
lines changed

1 file changed

+125
-11
lines changed

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

Lines changed: 125 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,125 @@ id: Release highlights
33
title: Release highlights
44
section: get-started
55
---
6-
76
import './get-started.css';
87
import { Divider, Timestamp } from '@patternfly/react-core';
98

10-
<Timestamp>January 2024</Timestamp>
9+
<Timestamp date={new Date(2025, 3)}>April 2025</Timestamp>
10+
11+
## PatternFly 6.2
12+
13+
For the Q2 2025 PatternFly release we made progress in a few of our key initiatives, including PatternFly 6 migration enablement, component animations, React 19 support, and the continued evolution of PatternFly AI. Updates for these key areas can be found here, in this quarter's release highlights.
14+
15+
### Promoted package versions
16+
17+
The following packages were promoted with this release. Outside of our primary initiatives for this release, we addressed reported bugs and continued to enhance PatternFly with new features, as detailed in the linked changelogs.
18+
19+
- patternfly/patternfly ([changelog](https://github.com/patternfly/patternfly/releases/tag/v6.2.0))
20+
- [@patternfly/patternfly@6.2.0](https://www.npmjs.com/package/@patternfly/patternfly)
21+
- patternfly/react ([changelog](https://github.com/patternfly/patternfly-react/releases/tag/v6.2.0))
22+
- [@patternfly/react-charts@8.2.0](https://www.npmjs.com/package/@patternfly/react-charts)
23+
- [@patternfly/react-code-editor@6.2.0](https://www.npmjs.com/package/@patternfly/react-code-editor)
24+
- [@patternfly/react-core@6.2.0](https://www.npmjs.com/package/@patternfly/react-core)
25+
- [@patternfly/react-drag-drop@6.2.0](https://www.npmjs.com/package/@patternfly/react-drag-drop)
26+
- [@patternfly/icons@1.0.4](https://www.npmjs.com/package/@patternfly/icons)
27+
- [@patternfly/react-styles@6.2.0](https://www.npmjs.com/package/@patternfly/react-styles)
28+
- [@patternfly/react-table@6.2.0](https://www.npmjs.com/package/@patternfly/react-table)
29+
- [patternfly/react-templates@6.2.0](https://www.npmjs.com/package/@patternfly/react-templates)
30+
- [@patternfly/react-tokens@6.2.0](https://www.npmjs.com/package/@patternfly/react-tokens)
31+
- PatternFly extensions
32+
- [@patternfly/chatbot@2.2.0](https://www.npmjs.com/package/@patternfly/chatbot) ([changelog](https://github.com/patternfly/chatbot/releases/tag/v2.2.0))
33+
- [@patternfly/quickstarts@6.2.0](https://www.npmjs.com/package/@patternfly/quickstarts) ([changelog](https://github.com/patternfly/patternfly-quickstarts/releases/tag/v6.2.0))
34+
- [@patternfly/react-catalog-view-extension@6.1.0](https://www.npmjs.com/package/@patternfly/react-catalog-view-extension) ([changelog](https://github.com/patternfly/react-catalog-view/releases/tag/v6.1.0))
35+
- [@patternfly/react-component-groups@6.2.0](https://www.npmjs.com/package/@patternfly/react-component-groups) ([changelog](https://github.com/patternfly/react-component-groups/releases/tag/v6.2.0))
36+
- [@patternfly/react-log-viewer@6.1.0](https://www.npmjs.com/package/@patternfly/react-log-viewer) ([changelog](https://github.com/patternfly/react-log-viewer/releases/tag/v6.1.0))
37+
- [@patternfly/react-topology@6.2.0](https://www.npmjs.com/package/@patternfly/react-topology) ([changelog](https://github.com/patternfly/react-topology/releases/tag/v6.2.0))
38+
- [@patternfly/react-user-feedback@6.1.0](https://www.npmjs.com/package/@patternfly/react-user-feedback) ([changelog](https://github.com/patternfly/react-user-feedback/releases/tag/v6.1.0))
39+
40+
### PatternFly 6 enablement
41+
42+
As products have continued their PatternFly 6 migration journeys, we've received helpful feedback on the upgrade process, including common roadblocks and situations that could use more guidance. So, we expanded and reorganized the [PatternFly 6 upgrade guide](/get-started/upgrade) to more clearly and comprehensively support the upgrade process.
43+
44+
### Component animations
45+
46+
Our highly-anticipated animations project focuses on integrating motion design into PatternFly components, to enhance user experiences and provide additional cues for interaction. You can keep track of this project via [our micro-animations roadmap](https://github.com/orgs/patternfly/projects/16/views/23?pane=issue&itemId=86507128&issue=patternfly%7Cpf-roadmap%7C215).
47+
48+
Note that animations will either be specified as opt-in or opt-out:
49+
- **Opt-in:** Requires additional updates to your codebase in order to function properly. These could cause test failures, depending on how your testing is set up, so you must manually opt into these animations and configure them appropriately.
50+
- **Opt-out:** Turned on by default. To disable these animations, work with the PatternFly team to find a solution.
51+
52+
With this release, 3 components now support animations:
53+
54+
1. [Alert](/components/alert)
55+
- **Animation type:** Opt-in.
56+
- **Animation behavior:** For alerts within a group, there's a slide-in animation as new alerts are received and a slide-out animation as alerts are dismissed.
57+
- **Example:** To visualize the motion behavior, you can interact with our website examples, which have opted in to animations.
58+
- **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 a group, you must ensure that new alerts are prepended to the alert group list, rather than appended to the end of it.
59+
1. [Navigation](/components/navigation)
60+
- **Animation type:** Opt-out.
61+
- **Animation behavior:** For expandable navigation items, the sub-menu fades in and out as navigation items are expanded and collapsed.
62+
- **Example:** As an opt-out animation, you can see this motion behavior by default across expandable navigation items.
63+
1. [Notification badge](/components/notification-badge)
64+
- **Animation type:** Opt-in.
65+
- **Animation behavior:** When the animation is triggered (for example, when a new notification arrives), the bell icon has a "ring" animation.
66+
- **Example:** To illustrate the motion behavior of this animation, we added a [notification badge "With animations" example](/components/notification-badge#with-animation).
67+
68+
### React 19 support
69+
70+
We’ve made significant progress towards React 19 support in PatternFly, which is being tracked in [the React 19 roadmap](https://github.com/patternfly/pf-roadmap/issues/201). Our remaining work involves updating our React dependencies, testing version support, and creating any necessary support resources or documentation.
71+
72+
### PatternFly AI
73+
74+
In the world of PatternFly AI, we've continued our focus on expanding our ChatBot extension. As more Flyers have used ChatBot, we've gained insight into the types of new features that would have the most impact. To make progress on growing ChatBot needs, this release adds *many* new features, including [an inline drawer display mode](https://patternfly-org-pr-4493-site.surge.sh/patternfly-ai/chatbot/overview/demo/#inline-drawer-chatbot), the ability for users to give [message feedback](https://patternfly-org-pr-4493-site.surge.sh/patternfly-ai/chatbot/messages#message-feedback), [support for quick starts](https://patternfly-org-pr-4493-site.surge.sh/patternfly-ai/chatbot/messages#messages-with-quick-start-tiles), additional content types for [messages](/patternfly-ai/chatbot/messages#bot-messages), and much more.
75+
76+
To see a complete list of new ChatBot features, [view the changelog](https://github.com/patternfly/chatbot/releases/tag/v2.2.0).
77+
78+
Along with these new features, we've updated our documentation:
79+
- [The ChatBot design guidelines](/patternfly-ai/chatbot/overview/design-guidelines) have been updated to reflect new features, expand on previous guidance, and add higher-level patterns for ChatBots usage in products.
80+
- New [ChatBot analytics documentation](/patternfly-ai/chatbot/analytics) is also now available, which provides general guidance on the implementation of analytics tracking.
81+
82+
### Notable changes
83+
84+
Outside of our key initiatives, there are a few notable changes that may require changes to your codebase and tests.
85+
86+
#### Components
87+
- Button
88+
- **Change:** The `aria-disabled` will now only render when `true`, not on elements where it is `false` or `undefined`.
89+
- **Required update:** Update tests that either:
90+
- Check for `aria-disabled` to be `false`
91+
- Match the disabled property
92+
- Charts
93+
- **Change:** Errors related to Victory 37.3.4 have been addressed.
94+
- **Required update:** 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.
95+
96+
- Table
97+
- **Change:** The [column management](/components/table/react-demos#column-management) and [column management with draggable](/components/table/react-demos#column-management-with-draggable) features have been rewritten to replace the use of the deprecated `<DragDrop>` component.
98+
- **Required update:** Remove the deprecated `<DragDrop>` component by referring to the updated table demos.
99+
100+
#### Extensions
101+
- ChatBot
102+
- **Change:** DOMpurify is no longer a dependency.
103+
- **Required update:** Uninstall/remove DOMpurify from your codebases.
104+
- ChatBot
105+
- **Change:** `<MessageBar>` is now a [PatternFly `<TextArea>`](/components/forms/text-area), which leads to the following type changes for `<MessageBarProps>`:
106+
- `onChange`:
107+
- Before: `(event: React.ChangeEvent<HTMLDivElement>, value: string) => void;`
108+
- After: `(event: React.ChangeEvent<HTMLTextAreaElement>, value: string | number) => void;`
109+
- `onSendMessage`:
110+
- Before: `(message: string) => void;`
111+
- After: `(message: string | number) => void;`
112+
- **Required update:** Where relevant, update the Typescript types for `<MessageBarProps>`.
113+
- Quick starts
114+
- **Change:** The markdown parser has been changed to one that's more actively being maintained.
115+
- **Required update:** Verify that any custom markdown extensions you use still work properly. This is where bugs are most likely from this change.
116+
- 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).
117+
118+
### What's next?
119+
120+
For the Q3 release of PatternFly, we will continue to focus on the initiatives mentioned in this release, fix bugs, and address any new, critical priorities that come up. To stay up to date with our primary focus areas, you can keep track of [the PatternFly Roadmap initiatives board](https://github.com/orgs/patternfly/projects/16/views/23).
121+
122+
<Divider />
123+
124+
<Timestamp date={new Date(2025, 0)}>January 2025</Timestamp>
11125

12126
## PatternFly 6.1.1
13127

@@ -20,7 +134,7 @@ As a quick follow up to our last release, this update publishes the new data vie
20134

21135
<Divider />
22136

23-
<Timestamp>December 2024</Timestamp>
137+
<Timestamp date={new Date(2024, 11)}>December 2024</Timestamp>
24138

25139
## PatternFly 6.1
26140

@@ -96,7 +210,7 @@ We've continued to evolve our new ChatBot:
96210

97211
<Divider />
98212

99-
<Timestamp>October 2024</Timestamp>
213+
<Timestamp date={new Date(2024, 9)}>October 2024</Timestamp>
100214

101215
## PatternFly 6.0
102216
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.
@@ -142,7 +256,7 @@ We made many updates to our [component groups extension](/component-groups/about
142256

143257
Our updated documentation includes:
144258

145-
| **Category** | **Components** |
259+
| **Category*- | **Components*- |
146260
| --- | --- |
147261
| Content containers | - Details page <br /> - Multi-content card<br /> - Page header (previously named "content header")<br /> - Service card (new!) |
148262
| Controls | - Bulk select <br /> - Close button <br /> - Responsive actions (new!) |
@@ -208,7 +322,7 @@ In addition to the previously mentioned documentation updates, we've made change
208322

209323
<Divider />
210324

211-
<Timestamp>August 2024</Timestamp>
325+
<Timestamp date={new Date(2024, 7)}>August 2024</Timestamp>
212326

213327
## PatternFly 6 beta
214328
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.
@@ -233,7 +347,7 @@ We made more improvements to our website docs, to ensure that they're accurate a
233347
- [All PatternFly tokens](/tokens/all-patternfly-tokens)
234348
- [Develop with tokens](/tokens/develop-with-tokens)
235349
- [Design with tokens](/tokens/design-with-tokens)
236-
- **Note:** Any @patternfly/react-tokens referencing global variables will need to be updated, since global variables have been replaced with tokens. Following our [token migration instructions](/tokens/develop-with-tokens#migrate-to-tokens) will help you determine the correct token to use.
350+
- **Note:*- Any @patternfly/react-tokens referencing global variables will need to be updated, since global variables have been replaced with tokens. Following our [token migration instructions](/tokens/develop-with-tokens#migrate-to-tokens) will help you determine the correct token to use.
237351
- Our design foundations
238352
- [Colors](/design-foundations/colors)
239353
- [Icons](/design-foundations/icons)
@@ -290,7 +404,7 @@ We applied PatternFly 6 styles to the rest of our extensions. All have now been
290404
- Catalog view
291405
- Quickstarts
292406

293-
Related design resources can also be found in [our PatternFly 6 Figma kit.](https://www.figma.com/@patternfly)
407+
Related design resources can also be found in [our PatternFly 6 Figma kit](https://www.figma.com/@patternfly).
294408

295409
### Bug fixes
296410
We fixed bugs that were reported throughout the alpha period including. We:
@@ -302,7 +416,7 @@ We fixed bugs that were reported throughout the alpha period including. We:
302416

303417
<Divider />
304418

305-
<Timestamp>June 2024</Timestamp>
419+
<Timestamp date={new Date(2024, 5)}>June 2024</Timestamp>
306420

307421
## PatternFly 6 alpha
308422

@@ -316,8 +430,8 @@ All of our components have a new look to match. As you use the alpha website, ta
316430

317431
### Design tokens
318432

319-
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)
433+
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).
320434

321435
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.
322436

323-
**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)
437+
**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).

0 commit comments

Comments
 (0)