Skip to content

Commit 2f43a7d

Browse files
committed
docs(chatbot): Updates chabot location to align with nav redesign.
1 parent 4c75821 commit 2f43a7d

File tree

16 files changed

+46503
-96
lines changed

16 files changed

+46503
-96
lines changed

.pnp.cjs

Lines changed: 32624 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.pnp.loader.mjs

Lines changed: 2126 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.yarn/install-state.gz

1.96 MB
Binary file not shown.

package-lock.json

Lines changed: 268 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

packages/module/package.json

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -33,49 +33,49 @@
3333
"tag": "prerelease"
3434
},
3535
"dependencies": {
36-
"@patternfly/react-core": "^6.1.0",
3736
"@patternfly/react-code-editor": "^6.1.0",
37+
"@patternfly/react-core": "^6.1.0",
3838
"@patternfly/react-icons": "^6.1.0",
3939
"@patternfly/react-table": "^6.1.0",
4040
"@segment/analytics-next": "^1.76.0",
41-
"posthog-js": "^1.194.4",
4241
"clsx": "^2.1.0",
42+
"path-browserify": "^1.0.1",
43+
"posthog-js": "^1.194.4",
4344
"react-markdown": "^9.0.1",
44-
"remark-gfm": "^4.0.0",
45-
"rehype-unwrap-images": "^1.0.0",
4645
"rehype-external-links": "^3.0.0",
4746
"rehype-sanitize": "^6.0.0",
48-
"path-browserify": "^1.0.1",
47+
"rehype-unwrap-images": "^1.0.0",
48+
"remark-gfm": "^4.0.0",
4949
"unist-util-visit": "^5.0.0"
5050
},
5151
"peerDependencies": {
5252
"react": "^18 || ^19",
5353
"react-dom": "^18 || ^19"
5454
},
5555
"devDependencies": {
56+
"@octokit/rest": "^18.0.0",
5657
"@patternfly/documentation-framework": "6.22.7",
5758
"@patternfly/patternfly": "^6.1.0",
5859
"@patternfly/patternfly-a11y": "^5.0.0",
5960
"@types/dom-speech-recognition": "^0.0.4",
6061
"@types/react": "^18.2.61",
62+
"estree-util-is-identifier-name": "^3.0.0",
63+
"file-saver": "^2.0.5",
6164
"rimraf": "^2.7.1",
6265
"typescript": "^5.3.3",
63-
"@octokit/rest": "^18.0.0",
66+
"unified": "^11.0.5",
67+
"victory-bar": "^37.1.1",
6468
"victory-core": "^37.1.1",
65-
"victory-scatter": "^37.1.1",
66-
"victory-pie": "^37.1.1",
67-
"victory-stack": "^37.1.1",
68-
"victory-legend": "^37.1.1",
69-
"victory-line": "^37.1.1",
70-
"victory-group": "^37.1.1",
71-
"victory-voronoi-container": "^37.1.1",
7269
"victory-create-container": "^37.1.1",
7370
"victory-cursor-container": "^37.1.1",
71+
"victory-group": "^37.1.1",
72+
"victory-legend": "^37.1.1",
73+
"victory-line": "^37.1.1",
74+
"victory-pie": "^37.1.1",
75+
"victory-scatter": "^37.1.1",
76+
"victory-stack": "^37.1.1",
7477
"victory-tooltip": "^37.1.1",
75-
"victory-bar": "^37.1.1",
76-
"file-saver": "^2.0.5",
77-
"unified": "^11.0.5",
78-
"estree-util-is-identifier-name": "^3.0.0"
78+
"victory-voronoi-container": "^37.1.1"
7979
},
8080
"overrides": {
8181
"puppeteer": "^23.6.1",
Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
section: PatternFly-AI
2+
section: Extensions
33
subsection: ChatBot
44
id: Overview
55
sortValue: 1
@@ -15,30 +15,30 @@ _Only use this ChatBot when it adds value to your users' experiences._ Don't use
1515
## ChatBot demos
1616

1717
To illustrate the capabilities of the ChatBot, including more complex interaction patterns, we've created these demos:
18-
- [Basic ChatBot](/patternfly-ai/chatbot/overview/demo#basic-chatbot)
19-
- [Embedded ChatBot](/patternfly-ai/chatbot/overview/demo#embedded-chatbot)
20-
- [Comparing ChatBots](/patternfly-ai/chatbot/overview/demo/#comparing-chatbots)
21-
- [Message feedback](/patternfly-ai/chatbot/messages/demo#message-feedback)
22-
- [ChatBot attachments via file upload](/patternfly-ai/chatbot/messages/demo#attach-via-upload-button-in-message-bar)
23-
- [ChatBot attachments via built-in menu](/patternfly-ai/chatbot/messages/demo#attach-via-menu-of-options-in-message-bar)
18+
- [Basic ChatBot](/extensions/chatbot/overview/demo#basic-chatbot)
19+
- [Embedded ChatBot](/extensions/chatbot/overview/demo#embedded-chatbot)
20+
- [Comparing ChatBots](/extensions/chatbot/overview/demo/#comparing-chatbots)
21+
- [Message feedback](/extensions/chatbot/messages/demo#message-feedback)
22+
- [ChatBot attachments via file upload](/extensions/chatbot/messages/demo#attach-via-upload-button-in-message-bar)
23+
- [ChatBot attachments via built-in menu](/extensions/chatbot/messages/demo#attach-via-menu-of-options-in-message-bar)
2424

2525
To learn how to write for ChatBot experiences, refer to our [conversation design guidelines](/patternfly-ai/conversation-design/#writing-for-chatbots).
2626

27-
To learn how to design ChatBot experiences, [refer to the design guidelines](/patternfly-ai/chatbot/overview/design-guidelines).
27+
To learn how to design ChatBot experiences, [refer to the design guidelines](/extensions/chatbot/overview/design-guidelines).
2828

2929
Explore our documentation, which covers both ChatBot UI components and message-related components:
3030
- UI
31-
- [Structural elements](/patternfly-ai/chatbot/ui#structure)
32-
- [Toggle](/patternfly-ai/chatbot/ui#toggle)
33-
- [Header](/patternfly-ai/chatbot/ui#header)
34-
- [Footer](/patternfly-ai/chatbot/ui#footer)
35-
- [Navigation](/patternfly-ai/chatbot/ui#navigation)
36-
- [Modals](/patternfly-ai/chatbot/ui#modals)
31+
- [Structural elements](/extensions/chatbot/ui#structure)
32+
- [Toggle](/extensions/chatbot/ui#toggle)
33+
- [Header](/extensions/chatbot/ui#header)
34+
- [Footer](/extensions/chatbot/ui#footer)
35+
- [Navigation](/extensions/chatbot/ui#navigation)
36+
- [Modals](/extensions/chatbot/ui#modals)
3737
- Messages
38-
- [Bot and user messages](/patternfly-ai/chatbot/messages)
39-
- [File attachments](/patternfly-ai/chatbot/messages#attachments)
38+
- [Bot and user messages](/extensions/chatbot/messages)
39+
- [File attachments](/extensions/chatbot/messages#attachments)
4040
- Analytics support
41-
- [Overview](/patternfly-ai/chatbot/analytics)
41+
- [Overview](/extensions/chatbot/analytics)
4242

4343

4444
We will continue to grow and evolve our ChatBot. If you notice a bug or have any suggestions, feel free to file an issue in our [GitHub repository!](https://github.com/patternfly/chatbot/issues) Make sure to check if there is already a pre-existing issue before creating a new one.

packages/module/patternfly-docs/content/extensions/chatbot/design-guidelines.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
section: PatternFly-AI
2+
section: Extensions
33
subsection: ChatBot
44
id: Overview
55
sortValue: 1
@@ -22,7 +22,7 @@ import "./images.css"
2222
1. **Attachments:** Details about files that a user has uploaded to the ChatBot.
2323
1. **Footer:** A persistent region at the bottom of the ChatBot window that contains the message bar and the footnote.
2424
1. **Footnote (optional):** A persistent, short message that contains any legal disclaimers or important information about the ChatBot. Footnotes are optional, but strongly recommended. More details can be found in the [footnote guidelines](#footnotes).
25-
1. **Toggle:** The button that allows users to open and close the ChatBot window. When the ChatBot is opened, the toggle should appear below the ChatBot window. The toggle shape and icon can be customized as needed, as shown in these [ChatBot toggle examples](/patternfly-ai/chatbot/ui#custom-toggle-icon). More details can be found in the [guidelines for accessing a ChatBot](#accessing-a-chatbot).
25+
1. **Toggle:** The button that allows users to open and close the ChatBot window. When the ChatBot is opened, the toggle should appear below the ChatBot window. The toggle shape and icon can be customized as needed, as shown in these [ChatBot toggle examples](/extensions/chatbot/ui#custom-toggle-icon). More details can be found in the [guidelines for accessing a ChatBot](#accessing-a-chatbot).
2626

2727
### Messages
2828

@@ -37,7 +37,7 @@ import "./images.css"
3737
1. **Timestamp:** The relative or absolute time that a message was sent.
3838
1. **Label:** Labels ChatBot messages as "AI."
3939
1. **Quick responses:** Programmable, clickable actions that allow users to quickly answer questions from the ChatBot.
40-
1. **Message actions:** Actions that allow users to interact with a bot message. These typically include providing feedback, copying, sharing, or reading aloud, but [custom message actions](/patternfly-ai/chatbot/messages#custom-message-actions) are also supported. More details for the feedback actions can be found in the [message feedback](#message-feedback) section.
40+
1. **Message actions:** Actions that allow users to interact with a bot message. These typically include providing feedback, copying, sharing, or reading aloud, but [custom message actions](/extensions/chatbot/messages#custom-message-actions) are also supported. More details for the feedback actions can be found in the [message feedback](#message-feedback) section.
4141

4242
#### Welcome message
4343

@@ -77,7 +77,7 @@ Selecting the quick start title, or the "Start" link can be configured to launch
7777

7878
### Message actions
7979

80-
To allow users to interact with bot messages, utilize message actions. Refer to [the message actions React example](/patternfly-ai/chatbot/messages#message-actions) for an interactive visual.
80+
To allow users to interact with bot messages, utilize message actions. Refer to [the message actions React example](/extensions/chatbot/messages#message-actions) for an interactive visual.
8181

8282
The following actions can be used for some of the most common interactions:
8383

@@ -90,7 +90,7 @@ The following actions can be used for some of the most common interactions:
9090
1. **Copy:** Copies the message content to the clipboard.
9191
1. **Listen:** Reads the message content out loud.
9292

93-
You can also use [custom message actions](/patternfly-ai/chatbot/messages#custom-message-actions) as needed for your particular use case. When using custom actions, be sure to add a tooltip that describes the effect that the action will have. For more information, view [our tooltips guidelines](/ux-writing/tooltips).
93+
You can also use [custom message actions](/extensions/chatbot/messages#custom-message-actions) as needed for your particular use case. When using custom actions, be sure to add a tooltip that describes the effect that the action will have. For more information, view [our tooltips guidelines](/ux-writing/tooltips).
9494

9595
#### Message feedback
9696

@@ -132,7 +132,7 @@ To message the ChatBot, users can type directly into the message bar in the foot
132132
1. **Use microphone button:** Supports speech recognition to allow users to use voice input. This feature is currently only available in Chrome and Safari.
133133
1. **Send button:** Allows users to send a typed message. This button should be disabled until a user has input text.
134134

135-
When a user chooses to use speech input via the microphone button, the button will display a pulsing animation to indicate that the ChatBot is listening to the user (as shown in [this speech recognition example](/patternfly-ai/chatbot/ui#message-bar-with-speech-recognition-and-file-attachment)).
135+
When a user chooses to use speech input via the microphone button, the button will display a pulsing animation to indicate that the ChatBot is listening to the user (as shown in [this speech recognition example](/extensions/chatbot/ui#message-bar-with-speech-recognition-and-file-attachment)).
136136

137137
<div class="ws-docs-content-img">
138138
![Animation phases of the listening button in the message bar.](./img/listening-pulse.svg)
@@ -265,7 +265,7 @@ As much as possible, the suggested prompts should consider the user’s location
265265

266266
Instead of automatically initiating what sounds like a request from a user, the ChatBot should ask users to confirm or deny their intent. This differentiates moments where users are simply asking about feasibility, rather than actually making a request.
267267

268-
This can be done using the [quick response](/patternfly-ai/chatbot/messages#messages-with-quick-responses) buttons:
268+
This can be done using the [quick response](/extensions/chatbot/messages#messages-with-quick-responses) buttons:
269269

270270
<div class="ws-docs-content-img">
271271
![Confirmation options from a bot in response to a user's request.](./img/quick-response-confirmation.svg)
@@ -309,7 +309,7 @@ Within the settings menu, users can select their preferences for a variety of Ch
309309

310310
### Attaching files
311311

312-
Using [the attach button](/patternfly-ai/chatbot/overview/design-guidelines#message-bar) in the message bar, users can [attach files](/patternfly-ai/chatbot/messages#file-attachments) to their message to share with the ChatBot.
312+
Using [the attach button](/extensions/chatbot/overview/design-guidelines#message-bar) in the message bar, users can [attach files](/extensions/chatbot/messages#file-attachments) to their message to share with the ChatBot.
313313

314314
The attach button can follow a couple of patterns, including:
315315

@@ -332,7 +332,7 @@ If a message attachment is successful, a label with the file details will be dis
332332
![File attached to user message.](./img/attached-file.svg)
333333
</div>
334334

335-
Users can select the file label to either preview or edit their attachment, as shown in these [attachment examples](/patternfly-ai/chatbot/messages#attachment-preview).
335+
Users can select the file label to either preview or edit their attachment, as shown in these [attachment examples](/extensions/chatbot/messages#attachment-preview).
336336

337337
If a message attachment fails, an error message should share the reason for failure:
338338

@@ -382,7 +382,7 @@ There are a few display modes that users can choose when interacting with a Chat
382382

383383
### Layouts
384384

385-
ChatBot supports a side-by-side [comparison layout](/patternfly-ai/chatbot/overview/demo#comparing-chatbots), which allows users to compare 2 chats at once. This can be helpful to let users understand how different models respond to the same prompt.
385+
ChatBot supports a side-by-side [comparison layout](/extensions/chatbot/overview/demo#comparing-chatbots), which allows users to compare 2 chats at once. This can be helpful to let users understand how different models respond to the same prompt.
386386

387387
<div class="ws-docs-content-img">
388388
![2 ChatBots in comparison mode.](./img/comparison.svg)

packages/module/patternfly-docs/content/extensions/chatbot/examples/Analytics/Analytics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
# Sidenav top-level section
33
# should be the same for all markdown files
4-
section: PatternFly-AI
4+
section: Extensions
55
subsection: ChatBot
66
# Sidenav secondary level section
77
# should be the same for all markdown files

packages/module/patternfly-docs/content/extensions/chatbot/examples/Customizing Messages/Customizing Messages.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
# Sidenav top-level section
33
# should be the same for all markdown files
4-
section: PatternFly-AI
4+
section: Extensions
55
subsection: ChatBot
66
# Sidenav secondary level section
77
# should be the same for all markdown files

packages/module/patternfly-docs/content/extensions/chatbot/examples/Messages/Messages.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
# Sidenav top-level section
33
# should be the same for all markdown files
4-
section: PatternFly-AI
4+
section: Extensions
55
subsection: ChatBot
66
# Sidenav secondary level section
77
# should be the same for all markdown files
@@ -130,9 +130,9 @@ You can apply a `clickedAriaLabel` and `clickedTooltipContent` once a button is
130130

131131
### Message feedback
132132

133-
When a user selects a positive or negative [message action](#message-actions), you can display a message feedback card that acknowledges their response and provides space for additional written feedback. These cards can be manually dismissed via the close button and the thank-you card can be [configured to time out automatically](/patternfly-ai/chatbot/messages#message-feedback-with-timeouts).
133+
When a user selects a positive or negative [message action](#message-actions), you can display a message feedback card that acknowledges their response and provides space for additional written feedback. These cards can be manually dismissed via the close button and the thank-you card can be [configured to time out automatically](/extensions/chatbot/messages#message-feedback-with-timeouts).
134134

135-
You can see the full feedback flow [in the message demos](/patternfly-ai/chatbot/messages/demo#message-feedback).
135+
You can see the full feedback flow [in the message demos](/extensions/chatbot/messages/demo#message-feedback).
136136

137137
The message feedback cards will immediately receive focus by default, but you can remove this behavior by passing `focusOnLoad: false` to the `<Message>` (as shown in the following examples). For better usability, you should generally keep the default focus behavior.
138138

@@ -243,7 +243,7 @@ You can add custom content to specific parts of a `<Message>` via the `extraCont
243243

244244
### Messages with attachments
245245

246-
When [attachments](/patternfly-ai/chatbot/messages#file-attachments) are shared and displayed in the ChatBot window, users will see a selectable and dismissible message that contains file details in a label. Selecting the file label can open a preview modal, which allows users to view or make edits to the file contents.
246+
When [attachments](/extensions/chatbot/messages#file-attachments) are shared and displayed in the ChatBot window, users will see a selectable and dismissible message that contains file details in a label. Selecting the file label can open a preview modal, which allows users to view or make edits to the file contents.
247247

248248
The `<PreviewAttachment>` component displays a modal with a read-only view of the attached file's contents. Selecting the "edit" button will open the `<AttachmentEdit>` component, which provides an interactive environment where users can make changes to the file.
249249

0 commit comments

Comments
 (0)