From e366cb20437b3d18ded9c76fa5e7f8c0c997d2de Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Wed, 3 Jan 2024 16:34:23 -0500 Subject: [PATCH 1/7] docs(releases): Adds release highlights for v5.2 --- .../content/get-started/release-highlights.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index bf29b019d4..93f017e114 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -7,6 +7,56 @@ section: get-started import './get-started.css'; import { Divider } from '@patternfly/react-core'; +## PatternFly 5.2 + +As part of our [quarterly release cadence](/get-started/about#patternfly-release-cadence), we're excited to announce that PatternFly 5.1 is now live. + +To help provide a high-level view of what's new, we've pulled together the major highlights from this release. Keep reading to learn more! + +### Design token support across components + +To prepare for our release of Penta, our upcoming new PatternFly theme, we added design token support to many of our components. + +This work is a large-scale undertaking that lays the groundwork for our upcoming alpha release of Penta. + +List the completed components? + +### React seed + +https://github.com/patternfly/patternfly-react-seed + +### Component groups extension + +We released a new extension: [component groups](/extensions/component-groups/about-component-groups). This extension contains a range of React components that are more complex than basic PatternFly components. These component groups combine and adjust multiple base components to provide opinionated solutions for recurring use cases across products using PatternFly. + +Note that component groups is contained in its own [GitHub repository](https://github.com/patternfly/react-component-groups). + +This extension was created to migrate components from the [Red Hat Insights shared components repository](https://github.com/RedHatInsights/frontend-components). The PatternFly component groups extension is recommended in place of the RedHat Insights implementation. To migrate to the component groups extension, refer to this [migration guide](https://github.com/patternfly/react-component-groups/blob/main/migration.md) that we put together. + +The latest version of component groups contains the following components: + +- Ansible +- Battery +- DetailsPage (beta) +- Error boundary +- Error state +- Invalid object +- Not authorized +- Skeleton table +- Tag count +- Unavailable content +- Warning modal + +We plan to continue to add additional components as they are requested. + +### Accessibility guideline documentation + +We've updated all of our [top-level accessibility guidelines](https://www.patternfly.org/accessibility/accessibility-fundamentals) + +As part of these updates, we've added a new page called "Design for accessibility", which documents accessibility considerations for visual designers. + + + ## PatternFly 5.1 As part of our [quarterly release cadence](/get-started/about#patternfly-release-cadence), we're excited to announce that PatternFly 5.1 is now live. From a6d68fe45d5b3fd941a0f34493821096047913d4 Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Fri, 5 Jan 2024 10:55:45 -0500 Subject: [PATCH 2/7] docs(release-highlights): Adds release highlights for 5.2 release. --- .../content/get-started/release-highlights.md | 39 ++++++++++++------- 1 file changed, 24 insertions(+), 15 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index 93f017e114..a80147d687 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -9,31 +9,31 @@ import { Divider } from '@patternfly/react-core'; ## PatternFly 5.2 -As part of our [quarterly release cadence](/get-started/about#patternfly-release-cadence), we're excited to announce that PatternFly 5.1 is now live. +We're excited to announce that PatternFly 5.1 is now live! Continue reading to learn about the major highlights from this release. -To help provide a high-level view of what's new, we've pulled together the major highlights from this release. Keep reading to learn more! +### Design token support preparation -### Design token support across components +To prepare for PatternFly's upcoming addition of a new visual theme, called Penta, we added support for design tokens to many of our components. This support has been enabled in both the visual design of components, as well as their code implementation. -To prepare for our release of Penta, our upcoming new PatternFly theme, we added design token support to many of our components. +This work is a large-scale undertaking that lays the groundwork for our upcoming v6 alpha release -- slotted for Q1 2024. -This work is a large-scale undertaking that lays the groundwork for our upcoming alpha release of Penta. +***[Here are the components that we've prepared OR here are the remaining components that we will complete ahead of our alpha release.]*** -List the completed components? +#### React seed -### React seed +***[I've heard mention of this, but don't know much about it -- do we want to include it here?]*** -https://github.com/patternfly/patternfly-react-seed +We readied our [React seed codebase](https://github.com/patternfly/patternfly-react-seed) for the v6 alpha release, so that any web applications built on PatternFly will have access to our Penta theme at the same time as our React and HTML consumers. ### Component groups extension -We released a new extension: [component groups](/extensions/component-groups/about-component-groups). This extension contains a range of React components that are more complex than basic PatternFly components. These component groups combine and adjust multiple base components to provide opinionated solutions for recurring use cases across products using PatternFly. +We released a new extension, called [component groups](/extensions/component-groups/about-component-groups). This extension contains a range of React components that are more complex than standard PatternFly components. These component groups combine and adjust multiple base components to provide opinionated solutions for recurring use cases across products using PatternFly. Note that component groups is contained in its own [GitHub repository](https://github.com/patternfly/react-component-groups). -This extension was created to migrate components from the [Red Hat Insights shared components repository](https://github.com/RedHatInsights/frontend-components). The PatternFly component groups extension is recommended in place of the RedHat Insights implementation. To migrate to the component groups extension, refer to this [migration guide](https://github.com/patternfly/react-component-groups/blob/main/migration.md) that we put together. +This extension was created in an effort to migrate components from the [Red Hat Insights shared components repository](https://github.com/RedHatInsights/frontend-components). The PatternFly component groups extension is now recommended to be used in place of the RedHat Insights implementation. To update your product to using the component groups extension, refer to [our migration guide.](https://github.com/patternfly/react-component-groups/blob/main/migration.md) -The latest version of component groups contains the following components: +The latest version of component groups contains the following components, with full documentation on PatternFly.org: - Ansible - Battery @@ -47,13 +47,22 @@ The latest version of component groups contains the following components: - Unavailable content - Warning modal -We plan to continue to add additional components as they are requested. +To learn moreabout the story behind this project, read our article on our [Medium publication](https://medium.com/patternfly/introducing-component-groups-dbe054cac726). + +We plan to continue to add additional components as they are requested, so please get involved if you have feedback or new ideas! + +### Updated accessibility guideline documentation -### Accessibility guideline documentation +We updated all of our top-level accessibility guidelines for better clarity and organization. As part of these updates, we also added a new page called "Design for accessibility", which documents accessibility considerations for visual designers. -We've updated all of our [top-level accessibility guidelines](https://www.patternfly.org/accessibility/accessibility-fundamentals) +The following pages now have updated content -- take a read! -As part of these updates, we've added a new page called "Design for accessibility", which documents accessibility considerations for visual designers. +- [About accessibility](/accessibility/about-accessibility) (formerly named "Accessibility fundamentals") +- [Accessibility scorecard](/accessibility/accessibility-scorecard) +- [***Design for accessibility***](https://www.patternfly.org/accessibility/accessibility-fundamentals) +- Develop for accessibility (formerly named "Product development guide") +- [PatternFly's accessibility](/accessibility/patternflys-accessibility) +- [Testing your accessibility](/accessibility/patternflys-accessibility) From 99974f63b3b1abcef445d3193fb0f55e2a2d7677 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Fri, 19 Jan 2024 10:24:52 -0500 Subject: [PATCH 3/7] Update packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md Co-authored-by: Michael Coker <35148959+mcoker@users.noreply.github.com> --- .../patternfly-docs/content/get-started/release-highlights.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index a80147d687..60805d2714 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -9,7 +9,7 @@ import { Divider } from '@patternfly/react-core'; ## PatternFly 5.2 -We're excited to announce that PatternFly 5.1 is now live! Continue reading to learn about the major highlights from this release. +We're excited to announce that PatternFly 5.2 is now live! Continue reading to learn about the major highlights from this release. ### Design token support preparation From 0f96aa247072b9c7e4dbe6e8a2b0182099b91345 Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Wed, 31 Jan 2024 11:08:24 -0500 Subject: [PATCH 4/7] Adds more highlights. --- .../content/get-started/release-highlights.md | 48 ++++++++++++++----- 1 file changed, 35 insertions(+), 13 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index 60805d2714..b1f080ecf6 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -9,19 +9,19 @@ import { Divider } from '@patternfly/react-core'; ## PatternFly 5.2 -We're excited to announce that PatternFly 5.2 is now live! Continue reading to learn about the major highlights from this release. +PatternFly 5.2 is now live! Here are the highlights from this release. -### Design token support preparation +### Major release preparation -To prepare for PatternFly's upcoming addition of a new visual theme, called Penta, we added support for design tokens to many of our components. This support has been enabled in both the visual design of components, as well as their code implementation. +The next major version of PatternFly (v6) doesn't come out until later this year, but our team has started preparing some of its most significant updates. -This work is a large-scale undertaking that lays the groundwork for our upcoming v6 alpha release -- slotted for Q1 2024. +Our major development work from the past quarter lays the groundwork for our ***upcoming v6 alpha release***, which is slotted for Q1 2024. -***[Here are the components that we've prepared OR here are the remaining components that we will complete ahead of our alpha release.]*** +#### Design token support -#### React seed +To prepare for PatternFly's upcoming addition of a new visual theme, called "Penta", we added support for design tokens to many of our components. This support has been enabled in both the visual design of each component, as well as in their code implementation. -***[I've heard mention of this, but don't know much about it -- do we want to include it here?]*** +#### PatternFly React seed We readied our [React seed codebase](https://github.com/patternfly/patternfly-react-seed) for the v6 alpha release, so that any web applications built on PatternFly will have access to our Penta theme at the same time as our React and HTML consumers. @@ -29,7 +29,7 @@ We readied our [React seed codebase](https://github.com/patternfly/patternfly-re We released a new extension, called [component groups](/extensions/component-groups/about-component-groups). This extension contains a range of React components that are more complex than standard PatternFly components. These component groups combine and adjust multiple base components to provide opinionated solutions for recurring use cases across products using PatternFly. -Note that component groups is contained in its own [GitHub repository](https://github.com/patternfly/react-component-groups). +Note that the component groups extension is contained in its own [GitHub repository](https://github.com/patternfly/react-component-groups). This extension was created in an effort to migrate components from the [Red Hat Insights shared components repository](https://github.com/RedHatInsights/frontend-components). The PatternFly component groups extension is now recommended to be used in place of the RedHat Insights implementation. To update your product to using the component groups extension, refer to [our migration guide.](https://github.com/patternfly/react-component-groups/blob/main/migration.md) @@ -47,11 +47,33 @@ The latest version of component groups contains the following components, with f - Unavailable content - Warning modal -To learn moreabout the story behind this project, read our article on our [Medium publication](https://medium.com/patternfly/introducing-component-groups-dbe054cac726). +To learn more about the story behind this project, read our [Medium article](https://medium.com/patternfly/introducing-component-groups-dbe054cac726). We plan to continue to add additional components as they are requested, so please get involved if you have feedback or new ideas! -### Updated accessibility guideline documentation +### New React "next" components + +As a reminder, our next components will be promoted with our next major release. Once a next component is promoted, it becomes the default recommended implementation for that component. + +We introduced a next version of **[modal](/components/modal/react-next)**. With this change, the modal API will be composable, rather than React property based. + +We also introduced a next version of **[drag and drop](/components/drag-and-drop/react-next)** with [related demos](/components/drag-and-drop/react-next-demos). + +### Topology updates + +#### New additions + +We added a new `hulledOutline` property in `DefaultGroup`, which can be used to specify if a group's outline is `hulled` or `rect`. + +We added logic to hide tags when the detail level is low, since they were difficult to read. Hidden tags will reappear if you hover on an edge, as you zoom in, or if you view the screen in a larger format. + +#### Fixes + +We removed the use of `window` and `global` to resolve bundling issues. + +We updated the method in which we get node details to better support lower scales. Now, we get the topology details level directly from the graph, instead of through the `useDetailsLevel` hook. + +### Accessibility guideline updates We updated all of our top-level accessibility guidelines for better clarity and organization. As part of these updates, we also added a new page called "Design for accessibility", which documents accessibility considerations for visual designers. @@ -59,10 +81,10 @@ The following pages now have updated content -- take a read! - [About accessibility](/accessibility/about-accessibility) (formerly named "Accessibility fundamentals") - [Accessibility scorecard](/accessibility/accessibility-scorecard) -- [***Design for accessibility***](https://www.patternfly.org/accessibility/accessibility-fundamentals) -- Develop for accessibility (formerly named "Product development guide") +- [Design for accessibility](/accessibility/accessibility-design) (**new!**) +- [Develop for accessibility](/accessibility/develop-for-accessibility) (formerly named "Product development guide") - [PatternFly's accessibility](/accessibility/patternflys-accessibility) -- [Testing your accessibility](/accessibility/patternflys-accessibility) +- [Testing your accessibility](/accessibility/testing-your-accessibility) From d2a53a2f020b9dd1725ec9ff7c6367d1ca72381d Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Thu, 1 Feb 2024 10:04:47 -0500 Subject: [PATCH 5/7] Adds coming soon section. --- .../content/get-started/release-highlights.md | 20 ++++++------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index b1f080ecf6..8494cfd61b 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -11,20 +11,6 @@ import { Divider } from '@patternfly/react-core'; PatternFly 5.2 is now live! Here are the highlights from this release. -### Major release preparation - -The next major version of PatternFly (v6) doesn't come out until later this year, but our team has started preparing some of its most significant updates. - -Our major development work from the past quarter lays the groundwork for our ***upcoming v6 alpha release***, which is slotted for Q1 2024. - -#### Design token support - -To prepare for PatternFly's upcoming addition of a new visual theme, called "Penta", we added support for design tokens to many of our components. This support has been enabled in both the visual design of each component, as well as in their code implementation. - -#### PatternFly React seed - -We readied our [React seed codebase](https://github.com/patternfly/patternfly-react-seed) for the v6 alpha release, so that any web applications built on PatternFly will have access to our Penta theme at the same time as our React and HTML consumers. - ### Component groups extension We released a new extension, called [component groups](/extensions/component-groups/about-component-groups). This extension contains a range of React components that are more complex than standard PatternFly components. These component groups combine and adjust multiple base components to provide opinionated solutions for recurring use cases across products using PatternFly. @@ -86,6 +72,12 @@ The following pages now have updated content -- take a read! - [PatternFly's accessibility](/accessibility/patternflys-accessibility) - [Testing your accessibility](/accessibility/testing-your-accessibility) +### Coming soon + +The next major version of PatternFly (v6) doesn't come out until later this year, but our team has started preparing for the release, which will include new theming capabilities and design token support. + +Keep an eye out for more information about the ***v6 alpha release*** , which is slotted for Q1 2024. + ## PatternFly 5.1 From 6e193ad0dca94068e0200896fdd8e25854821f58 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Thu, 1 Feb 2024 12:33:42 -0500 Subject: [PATCH 6/7] Update packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md Co-authored-by: Michael Coker <35148959+mcoker@users.noreply.github.com> --- .../patternfly-docs/content/get-started/release-highlights.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index 8494cfd61b..b16423ae95 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -19,7 +19,7 @@ Note that the component groups extension is contained in its own [GitHub reposit This extension was created in an effort to migrate components from the [Red Hat Insights shared components repository](https://github.com/RedHatInsights/frontend-components). The PatternFly component groups extension is now recommended to be used in place of the RedHat Insights implementation. To update your product to using the component groups extension, refer to [our migration guide.](https://github.com/patternfly/react-component-groups/blob/main/migration.md) -The latest version of component groups contains the following components, with full documentation on PatternFly.org: +The latest version of component groups contains the following components, with [full documentation on PatternFly.org](/extensions/component-groups/about-component-groups): - Ansible - Battery From 0f12bac18111fbac6c036ae33e2e5e0d392befd9 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Thu, 1 Feb 2024 12:33:49 -0500 Subject: [PATCH 7/7] Update packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md Co-authored-by: Michael Coker <35148959+mcoker@users.noreply.github.com> --- .../patternfly-docs/content/get-started/release-highlights.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md index b16423ae95..0d87e93182 100644 --- a/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md +++ b/packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md @@ -61,7 +61,7 @@ We updated the method in which we get node details to better support lower scale ### Accessibility guideline updates -We updated all of our top-level accessibility guidelines for better clarity and organization. As part of these updates, we also added a new page called "Design for accessibility", which documents accessibility considerations for visual designers. +We updated all of our top-level accessibility guidelines for better clarity and organization. As part of these updates, we also added a new page called [Design for accessibility](/accessibility/design-for-accessibility), which documents accessibility considerations for visual designers. The following pages now have updated content -- take a read!