Merge pull request mendix#9100 from mendix/MvM-PeerReviewMaia

Peer Review: Maia Chat

Author: Yiyun333

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md

@@ -9,10 +9,10 @@ aliases:
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-## Introduction 
+## Introduction
 
 {{% alert color="info" %}}
-MendixChat was rebranded to Maia Chat and released in GA in Studio Pro 10.12.0. It is also available in the Mendix Portal.
+Maia Chat was released for GA in Studio Pro 10.12.0. From Studio Pro 10.6 to 10.11, it was available as a beta feature and called MendixChat. Maia Chat is also available in the Mendix Portal. For more information, see the [Maia Chat](/developerportal/global-navigation/#maia-chat) section in **Global Navigation**.
 {{% /alert %}}
 
 {{% alert color="info" %}}
@@ -22,71 +22,63 @@ To use Maia Chat, an internet connection and signing in to Studio Pro are requir
 {{% alert color="info" %}}
 Maia Chat does not use any project, customer, or company information. It only uses the data that you have entered in the Chat. Please do not enter any personal or sensitive data!
 {{% /alert %}}
+ 
+Maia Chat is a built-in chat interface in the Mendix Platform powered by generative AI. Developers can ask questions about all aspects of Mendix, including how to apply concepts, best practices, governance tools, and development patterns. It is based on large language models (LLMs) using data from various resources, such as [Mendix Docs](/), [Mendix Community](https://community.mendix.com/), and [Mendix Academy](https://academy.mendix.com/).
+ 
+## Using Maia Chat in Studio Pro
 
-Maia Chat is a built-in chat interface in the Mendix Platform powered by Generative AI. Developers can ask questions about all aspects of Mendix, including how to apply concepts, best practices, governance tools, and development patterns. It is based on large language models (LLMs) using data from various resources, such as [Mendix Docs](/), [Mendix Community](https://community.mendix.com/), and [Mendix Academy](https://academy.mendix.com/).
-
-## Using Maia Chat
-
-There are two ways to access Maia Chat: 
+There are two ways to access Maia Chat in Studio Pro:
 
 * Click the **Maia** ({{% icon name="sparkles" %}}) icon to the right of the top bar.
 * Go to the **View** menu and click **Maia**.
 
 The chat interface appears at the right side of Studio Pro under the **Maia** pane:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png" width="300px">}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png" width="250px">}}
 
-### An Example of Interacting with Maia Chat
+You can start using Maia Chat by clicking one of the demo questions. Alternatively, you can ask your own question, and press <kbd>Enter</kbd> or click **Ask** to send the question. For information on the supported shortcut keys in Maia Chat, see the [Maia Chat Shortcut Keys](/refguide/keyboard-shortcuts/#maia-chat-shortcuts) section in *Keyboard Shortcuts*.
 
-You can start using Maia Chat by clicking one of the demo questions. You can also start by asking your own question in the chatbox. 
+For more information on Maia Chat features in Studio Pro, see the sub-sections below.
 
-The following steps present an example of how you can interact with Maia Chat by asking your own question:
+### Maia Chat Features in Studio Pro
 
-1. Type the following question in the chatbox: `When should I use a calculated attribute?`.
-2. Press <kbd>Enter</kbd> or the **Ask** button to send the question. You will then see the following:
-    * An answer generated by Maia Chat
-    * Top relevant references from various resources like Mendix documentation, Mendix Community, and Academy learning paths
+After a question is sent to Maia Chat, you will see the following in the chat interface:
 
-3. Click the thumbs up icon ({{% icon name="thumbs-up" %}}) or the thumbs down icon ({{% icon name="thumbs-down" %}}) to give your feedback on an answer. 
+* An answer generated by Maia Chat
+* Links to top relevant resources like Mendix documentation, Mendix Community, and Academy learning paths
 
-4. Click the add feedback icon ({{% icon name="notes-paper-edit" %}}) to provide a more detailed feedback. A detailed **Feedback** section shows below the answer:
+    {{% alert color="info" %}}In Studio Pro 10.7.0 and above, you can also see the Mendix version of the references, the level of the learning path if the reference comes from Mendix Academy, and the date and answer status if the reference comes from the Mendix Community.{{% /alert %}}
 
-    * You can rate the **correctness**, **completeness**, and **readability** of the provided answer.
-
-    * You can also provide **Additional feedback** if you want to. 
+* A copy icon ({{% icon name="copy" %}}) which allows you to copy the given answer to a clipboard (available in Studio Pro 10.7.0 and above)
+* Feedback icons
 
-      {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}} 
+#### Giving Feedback
 
-5. Click the **Submit feedback** button to submit your feedback. Afterwards, you will be brought back to the main chat interface where you can continue asking questions.
+Mendix encourages giving feedback on the answers generated by Maia Chat. Feedback will be used to further improve Maia Chat.
 
-6. Click **New chat** at beginning of your chat if you want to clear the messages and start a new conversation without reference to your current chat (this option was added in Studio Pro 10.7.0).
+There are several ways to give feedback on the generated answer:
 
-#### Studio Pro Features
+* Click the thumbs up icon ({{% icon name="thumbs-up" %}}) or the thumbs down icon ({{% icon name="thumbs-down" %}})
+* To provide more detailed feedback, click the add feedback icon ({{% icon name="notes-paper-edit" %}}). A detailed **Feedback** section shows below the answer:
 
-Maia Chat in Studio Pro has additional features which are indicated by the following:
+    {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}}
 
-* A copy icon ({{% icon name="copy" %}}) which allows you to copy the given answer to a clipboard (this option was added in 10.7.0)
-* Feedback icons
-* New chat option
-  
-    {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-example.png" width="350px" >}}
-    
-    {{% alert color="info" %}}In Studio Pro 10.7.0 and above, you can also see the Mendix version of the references, the level required if the reference comes from Mendix Academy, and the date and answer status if the reference comes from the Mendix Community.{{% /alert %}}
+    * You can rate the **correctness**, **completeness**, and **readability** of the provided answer.
+    * You can also provide **Additional feedback** if you want to.
+    * Remember to click **Submit feedback** to submit your feedback. Afterwards, you will be brought back to the main chat interface where you can continue asking questions.
 
-### Asking Follow-Up Questions
+#### Asking Follow-Up Questions
 
 In Studio Pro 10.8.0 and above, Maia Chat supports asking follow-up questions based on your previous question and the answer you have received. For example, you can ask it to summarize the latest answer you received by typing the following in the chat: *Can you summarize that?*.
 
 {{% alert color="info" %}}
-
 Maia Chat will lose track of the conversation history if you exit Studio Pro.
-
 {{% /alert %}}
 
-## Keyboard Support
-
-For information on the supported shortcut keys in Maia Chat, see the [Maia Chat Shortcut Keys](/refguide/keyboard-shortcuts/#maia-chat-shortcuts) section in *Keyboard Shortcuts*.
+#### New Chat
 
+In Studio Pro 10.7.0 and above, there is a **New chat** option at the top left of the chat interface. It allows you to clear the messages and start a new conversation which does not reference your current chat.
+ 
 ## Read More
 
-* [Maia Learn](/refguide/maia-learn/)
+Under the **Maia** pane, there is also a tab called **Learn**. For more information, see [Maia Learn](/refguide/maia-learn/).