Skip to content

Commit 5d334d4

Browse files
authored
Merge pull request #681 from edonehoo/org-iss4753
docs(chatbot): Updates chatbot location to align with nav redesign.
2 parents 4034ad9 + 6f33bca commit 5d334d4

File tree

14 files changed

+46218
-79
lines changed

14 files changed

+46218
-79
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.
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

@@ -91,7 +91,7 @@ The following actions can be used for some of the most common interactions:
9191
1. **Download:** Downloads the chat message. [Learn more about downloading chat transcripts](#downloading-chat-transcripts).
9292
1. **Listen:** Reads the message content out loud.
9393

94-
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).
94+
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).
9595

9696
#### Message feedback
9797

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

136-
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)).
136+
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)).
137137

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

267267
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.
268268

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

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

311311
### Attaching files
312312

313-
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.
313+
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.
314314

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

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

336-
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).
336+
Users can select the file label to either preview or edit their attachment, as shown in these [attachment examples](/extensions/chatbot/messages#attachment-preview).
337337

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

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

416416
### Layouts
417417

418-
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.
418+
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.
419419

420420
<div class="ws-docs-content-img">
421421
![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
@@ -144,9 +144,9 @@ You can apply a `clickedAriaLabel` and `clickedTooltipContent` once a button is
144144

145145
### Message feedback
146146

147-
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).
147+
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).
148148

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

151151
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.
152152

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

258258
### Messages with attachments
259259

260-
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.
260+
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.
261261

262262
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.
263263

0 commit comments

Comments
 (0)