Skip to content

pull in ai-guidelines#5022

Merged
jschuler merged 8 commits into
patternfly:mainfrom
jschuler:ai-guidelines
Jun 23, 2026
Merged

pull in ai-guidelines#5022
jschuler merged 8 commits into
patternfly:mainfrom
jschuler:ai-guidelines

Conversation

@jschuler

Copy link
Copy Markdown
Collaborator

Pulls into the website the ai guidelines from https://github.com/project-felt/ai-guidelines/tree/main

@jschuler jschuler marked this pull request as ready for review May 18, 2026 15:02
@jschuler

Copy link
Copy Markdown
Collaborator Author

marked as ready for review just to generate preview. It should still be considered draft though

@jschuler

Copy link
Copy Markdown
Collaborator Author

/deploy-preview

1 similar comment
@nicolethoen

Copy link
Copy Markdown
Collaborator

/deploy-preview

@patternfly-build

Copy link
Copy Markdown
Collaborator

Preview: https://pf-org--pr-5022-site.surge.sh

@jschuler

Copy link
Copy Markdown
Collaborator Author

/deploy-preview

1 similar comment
@nicolethoen

Copy link
Copy Markdown
Collaborator

/deploy-preview

@jschuler

Copy link
Copy Markdown
Collaborator Author

I've deployed it myself, can review here
https://ai-guidelines-legacy.surge.sh/ai/overview

@andrew-ronaldson andrew-ronaldson left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you remove the border-left styling on this figureelement. In this screenshot I made it a consistent 3px border width and a border-radius--md similar to our cards components.
Image

@thatblindgeye thatblindgeye left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In addition to the below, do we intend to include any more verbiage from the design-language.md file? Not entirely sure what may not live elsewhere/is releveant, but the "Do not use unique colors or gradients to indicate AI features. " verbiage for example, I know we had to update in Chatbot to remove some gradient border from the message bar, so if that doesn't get mentioned anywhere else in the AI sections wondering if that (plus whatever else) is still relevant to include on this ai.md file


## Using AI icons in React

The following AI icons are available in the [@patternfly/react-icons](https://www.npmjs.com/package/@patternfly/react-icons) package. For detailed usage guidelines, see [Iconography](/ai/guidelines/iconography).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The following AI icons are available in the [@patternfly/react-icons](https://www.npmjs.com/package/@patternfly/react-icons) package. For detailed usage guidelines, see [Iconography](/ai/guidelines/iconography).
The following AI icons are available in the [@patternfly/react-icons](https://www.npmjs.com/package/@patternfly/react-icons) package. The example text labels should only be applied to interactive elements that contain these icons, such as buttons or menu toggles. For detailed usage guidelines, see [Iconography](/ai/guidelines/iconography).

Just so users will know not to give the icon itself some accessible name. That, or using/tweaking the original text from the design-languages.md:

AI icons must also be paired with a button label or tooltip text that says "[ Action ] with AI" or "[ Action ] by AI" to ensure there are multiple indicators that AI is being used. You can adapt this text label between tenses as appropriate. For example, "Search with AI" or "Search results generated by AI."

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The upstream iconography page says icons should be "paired with text" but the figcaption on the do example explicitly says "Icons can be used in non-interactive components, like tags or labels, and on buttons."


| **Icon** | **React** | **Text label** | **Usage** |
| :---: | --- | --- | --- |
| <Icon size="lg"><RhUiAiExperienceIcon /></Icon> | RhUiAiExperienceIcon | | General AI identification, or when no other AI icon is appropriate. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we suggest using "AI" as a text label, or providing some verbiage that the user should choose an appropriate text label for the context as part of the "Usage" column for these 2?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the Iconography page already makes mention to pair with text like ''... with AI"

@jschuler

Copy link
Copy Markdown
Collaborator Author

@thatblindgeye the color gradient is addressed here https://ai-guidelines-legacy.surge.sh/ai/guidelines/color

@janwright73

Copy link
Copy Markdown
Contributor

lgtm! I have reviewed the AI style guide content that we are pulling in from project-felt/ai-guidelines. We are now consistent with RHDS (https://ux.redhat.com/ai-guidelines) which is part of our AC for the UIE 90 day delivery of KR #10 - https://redhat.atlassian.net/browse/UIESTRAT-19.

@andrew-ronaldson

andrew-ronaldson commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

The figure elements need a couple tweaks for glass mode. The generic figure elements should have border--width--regular and background global--background--color--primary--default

There is still an issue where the images have white backgrounds while the figure has transparency but it is less noticeable.

Screenshot 2026-06-23 at 12 02 55 PM Screenshot 2026-06-23 at 12 02 43 PM

@andrew-ronaldson andrew-ronaldson left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will need a follow up for the Felt images once that merges

@jschuler jschuler merged commit 27685d9 into patternfly:main Jun 23, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants