Skip to content

docs(AI): Updates AI resources with latest guidance.#4967

Open
edonehoo wants to merge 2 commits intopatternfly:mainfrom
edonehoo:iss4621
Open

docs(AI): Updates AI resources with latest guidance.#4967
edonehoo wants to merge 2 commits intopatternfly:mainfrom
edonehoo:iss4621

Conversation

@edonehoo
Copy link
Collaborator

Closes #4621 and #4792

Will require a follow-up in chatbot repo to add back some info I'm removing from these docs (handling unsafe user requests, message streaming)

@patternfly-build
Copy link
Collaborator

patternfly-build commented Mar 18, 2026

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

@edonehoo edonehoo requested a review from phcox March 20, 2026 18:32
Copy link

@phcox phcox left a comment

Choose a reason for hiding this comment

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

Hey Erin,

I concentrated mostly on the new Design Language page, but I did read everything else and it all looked good to me.

Comments on the Design Language page:

  • The images aren't being displayed very well. The resolution is off and they look grainy. The icons are somewhat better but even they seem a little off.
  • It seems like the two robot icon variants should be presented when they are being described, maybe even in context to better differentiate them.
  • Typo in this sentence: "Do not communicate the use of AI through icons alone. Ensure they are also paited with a text label or tooltip."
  • This sentence may not be entirely accurate: "Because avatars have personality and don't have interactive state changes, you can adjust the background colors of the standard robot icon, including adding soft gradients or drop shadows to create depth." I think the colors will be limited to either PF non-status or RH brand color for non-interactivity, but that conversation just got brought up again in our design language meeting. Kayla is going to talk to Andrew on 3/25 to try to come to a resolution. Regardless, we don't want to say that soft gradients and drop shadows are OK - we backed off that as we iterated on the deck.
  • This sentence: "There are different icon variations and animations available to show thinking states, react to content, or differentiate chatbot options." This isn't true at the moment. It's something we'll look at in the future. I suggest removing it.
  • This sentence: "AI is represented by a sparkle icon, which is square with slightly rounded corners." This is probably just a personal preference, but I don't think of that sparkle as being square; to me it's more like a diamond with concave sides.

That's all I've got. Looks really good!

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.

Update AI principles and guidelines.

3 participants