From df69e4fa9729842b58ae03dc75569190c46b15c3 Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Mon, 10 Mar 2025 11:56:50 -0400 Subject: [PATCH 01/19] docs(release-highlights): Adds highlights for 6.2 release. --- .../content/get-started/release-highlights.md | 102 +++++++++++++++++- 1 file changed, 99 insertions(+), 3 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 fed39d3299..c65f14ba0b 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,102 @@ section: get-started import './get-started.css'; import { Divider, Timestamp } from '@patternfly/react-core'; +March 2024 + +## PatternFly 6.2 + +### Promoted package versions +- patternfly/patternfly ([changelog](https://github.com/patternfly/patternfly/releases/tag/v6.2.0)) + - [@patternfly/patternfly@6.2.0](https://www.npmjs.com/package/@patternfly/patternfly) +- patternfly/react ([changelog](https://github.com/patternfly/patternfly-react/releases/tag/v6.2.0)) +- PatternFly extensions + - [@patternfly/chatbot@2.2.0](https://www.npmjs.com/package/@patternfly/chatbot) ([changelog](https://github.com/patternfly/chatbot/releases/tag/v2.2.0)) + +### Component updates + +#### Bugs +- Select: We fixed scrolling for menus with grouped items. +- Masthead: We correct vertical centering. + +#### Features +- + +### Extension updates + +#### ChatBot + +##### Bugs +- We fixed an overflow issue in popovers with long titles. +- We fixed the appearance of links. +- We removed the cancel button from the user feedback form, which was unnecessary due to the present of a close button. +- We made resize and form-control overrides more important to assist with downstream implementations. +- We added loading and error states to the conversation history. +- We made updates for general style consistency. + +##### Features +- We added the following 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). + - Additional message content types (as shown in the [bot messages](/patternfly-ai/chatbot/messages#bot-messages) examples): + - Inline error message. + - Block quotes. + - Headings. + - External links, with styling. + - Images. + - Tables in messages. + - **Note:** We're still updating our design guidelines to reflect these changes and will provide an update once they are complete. +- New documentation to guide the use of [analytics in ChatBots](/patternfly-ai/chatbot/analytics). + +#### 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 precedent 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. + +### Website updates + +##### Bugs +- We corrected a typo in the [PatternFly spacers table](/design-foundations/spacers/#patternfly-spacers). +- We adjusted the SVG download behavior for [PatternFly icons](/design-foundations/icons/#all-icons), to remove a wrapping `` that prevented imports into some design tools. +- We improved accessibility for the hover text of PatternFly logos in the website masthead and footer. + +##### 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. + + + January 2024 ## PatternFly 6.1.1 @@ -290,7 +386,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: @@ -316,8 +412,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). From cac204dd1e340284c1c7ee918c2ad24bbf770ac0 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 10 Mar 2025 14:22:55 -0400 Subject: [PATCH 02/19] couple typos --- .../patternfly-docs/content/get-started/release-highlights.md | 4 ++-- 1 file changed, 2 insertions(+), 2 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 c65f14ba0b..7400fad041 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 @@ -34,7 +34,7 @@ import { Divider, Timestamp } from '@patternfly/react-core'; ##### Bugs - We fixed an overflow issue in popovers with long titles. - We fixed the appearance of links. -- We removed the cancel button from the user feedback form, which was unnecessary due to the present of a close button. +- We removed the cancel button from the user feedback form, which was unnecessary due to the presence of a close button. - We made resize and form-control overrides more important to assist with downstream implementations. - We added loading and error states to the conversation history. - We made updates for general style consistency. @@ -76,7 +76,7 @@ import { Divider, Timestamp } from '@patternfly/react-core'; #### User feedback ##### Bugs -- We made updates to ensure that CSS overrides take precedent over PatternFly's default styles. +- We made updates to ensure that CSS overrides take precedence over PatternFly's default styles. #### Quick starts From 070244753c21cbecca965b8a5798402fdd5b19af Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Mon, 10 Mar 2025 16:45:19 -0400 Subject: [PATCH 03/19] Expands on chatbot updates and reorganizes some --- .../content/get-started/release-highlights.md | 62 +++++++++++++------ 1 file changed, 42 insertions(+), 20 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 7400fad041..e58228eda4 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 @@ -29,34 +29,56 @@ import { Divider, Timestamp } from '@patternfly/react-core'; ### Extension updates +#### Catalog view + +##### Bugs +- We resolved console errors that occurred when read-only badges were passed to `` via the `actions` prop. +- We adjusted [vertical tab](/extensions/catalog-view/vertical-tabs) styles to remove the underline. + #### ChatBot ##### Bugs - We fixed an overflow issue in popovers with long titles. -- We fixed the appearance of links. +- 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 resize and form-control overrides more important to assist with downstream implementations. -- We added loading and error states to the conversation history. +- We made some styling adjustments to the `` to assist with downstream implementations. - We made updates for general style consistency. ##### Features -- We added the following 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). - - Additional message content types (as shown in the [bot messages](/patternfly-ai/chatbot/messages#bot-messages) examples): - - Inline error message. - - Block quotes. - - Headings. - - External links, with styling. - - Images. - - Tables in messages. - - **Note:** We're still updating our design guidelines to reflect these changes and will provide an update once they are complete. -- New documentation to guide the use of [analytics in ChatBots](/patternfly-ai/chatbot/analytics). +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. + +**Note:** We're still updating our design guidelines to fully reflect these changes and will provide an update once they are complete. + +##### Other notable changes +- 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 `` to allow additional [rehype plugins](https://github.com/rehypejs/rehype) for further customization of Markdown parsing. +- We replaced the `` component with a [PatternFly `