Separate Maia into SP and Mx Portal docs

MariaShaposhnikova · MariaShaposhnikova · commit 6297ca8ecfe1 · 2025-02-04T14:35:29.000+01:00
diff --git a/content/en/docs/developerportal/global-navigation.md b/content/en/docs/developerportal/global-navigation.md
@@ -54,3 +54,43 @@ To stop receiving notifications when new feedback is submitted for a specific ap
 Click **Open Profile Menu** ({{% icon name="user" %}}) to access your [Mendix Profile](/community-tools/mendix-profile/), enable **Dark Mode**, and access your [Account Settings](/community-tools/mendix-profile/user-settings/#settings). 
 
 You can also sign out from the Mendix Platform via this menu.
+
+## Maia in Mendix Portal {#maia-mx-portal}
+
+Mendix AI Assistance (Maia) refers to Mendix Platform capabilities that leverage [artificial intelligence (AI)](https://www.mendix.com/glossary/artificial-intelligence-ai/) and [machine learning (ML)](https://www.mendix.com/glossary/machine-learning/) to assist developers in application development (via AI-assisted development (AIAD)). Maia is designed to help development teams in modeling and delivering Mendix applications faster, more consistently, and with higher quality. 
+
+Below are the Maia capabilities that are available in Mendix Portal:
+
+* **Maia Chat**  – a built-in chat interface, for more information, see the [Maia Chat](#maia-chat) section below.
+* **Maia Rewrite** – an AI-assisted writing aid integrated within the Mendix Community posting interface, which helps you to ask properly-formatted questions that are more likely to be answered. For more information on how to use it, see the [Asking Your Question](/community-tools/mendix-community/#asking-question) section in *Mendix Community*.
+* **Maia Summarize** – an AI-assisted summarizing aid which condenses lengthy discussions for a question posted on Mendix Community into key points, making it easier for you to find solutions to your questions without having to plough through every single answer in the thread. For more information on how to use it, see the [Question Details](/community-tools/mendix-community/#question-details) section in *Mendix Community*.
+
+### Maia Chat {#maia-chat}
+
+{{% alert color="info" %}}
+To use Maia Chat, an internet connection and signing in to Studio Pro or the Mendix Portal are required.
+{{% /alert %}}
+
+{{% 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. Maia Chat is generally available in Studio Pro 10.12.0 and the Mendix Portal. For more information on Maia Chat in Studio Pro, see [Maia Chat](/refguide/maia-chat/).
+
+For information on Mendix data storage policies and practices for Maia, see [Maia Privacy Policy](https://www.mendix.com/legal/privacy/maia/).
+
+#### Using Maia Chat
+
+You can access Maia Chat in Mendix Portal by clicking the **Maia** ({{% icon name="sparkles" %}}) icon to the right of the top bar.
+
+The chat interface appears at the right side of your browser window. You can start using Maia Chat either by clicking one of the demo questions or by asking your own question in the chatbox. 
+
+#### Asking Follow-Up Questions
+
+In Mendix Portal, 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 only keeps track of a conversation history within a session on a page in the Mendix Portal.
+
+{{% /alert %}}
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md
@@ -17,16 +17,13 @@ For information on Mendix data storage policies and practices for Maia, see [Mai
 
 For information on what third-party services Maia uses and what data are sent to the third-party services, see the [Maia Third-Party Services](#maia-third-party-services) section below.
 
-## Maia Chat 
-
-Maia Chat (generally available in Studio Pro 10.12.0 and the Mendix Portal) 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. For more information, see [Maia Chat](/refguide/maia-chat/).
-
 ## Maia Capabilities in Mendix Studio Pro 
 
 In addition to Maia Chat, Maia in Mendix Studio Pro has the following capabilities: 
 
 Guidance:
 
+* **Maia Chat** (generally available in Studio Pro 10.12.0 and the Mendix Portal) – a built-in chat interface powered by Generative AI in Studio Pro. It answers questions about app development in Mendix, including how to apply concepts, best practices, and development patterns. For more information, see [Maia Chat](/refguide/maia-chat/). 
 * **Maia Learn** (available in Studio Pro 10.18 and above) - helps you to quickly learn Mendix core concepts and get started with Studio Pro. For more information, see [Maia Learn](/refguide/maia-learn/).
 
 Recommenders:
@@ -43,10 +40,7 @@ Generators:
 
 ## Maia in Mendix Portal
 
-Below are the Maia capabilities that are available in Mendix Portal:
-
-* **Maia Rewrite** - an AI-assisted writing aid integrated within the Mendix Community posting interface, which helps you to ask properly-formatted questions that are more likely to be answered. For more information on how to use it, see the [Asking Your Question](/community-tools/mendix-community/#asking-question) section in *Mendix Community*.
-* **Maia Summarize** - an AI-assisted summarizing aid which condenses lengthy discussions for a question posted on Mendix Community into key points, making it easier for you to find solutions to your questions without having to plough through every single answer in the thread. For more information on how to use it, see the [Question Details](/community-tools/mendix-community/#question-details) section in *Mendix Community*.
+For more information on Maia in Mendix Portal, see the [Maia in Mendix Portal](/developerportal/global-navigation/#maia-mx-portal) section in *Global Navigation*.
 
 ## Maia Third-Party Services {#maia-third-party-services}
 
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md
@@ -29,10 +29,10 @@ Maia Chat is a built-in chat interface in the Mendix Platform powered by Generat
 
 There are two ways to access Maia Chat: 
 
-* In Studio Pro and Mendix Portal, click the **Maia** ({{% icon name="sparkles" %}}) icon to the right of the top bar.
-* In Studio Pro go to the **View** menu and click **Maia**
+* 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 your context window or browser. In Studio Pro you can find the dock under the **Maia** tab.
+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">}}
 
@@ -46,39 +46,41 @@ The following steps present an example of how you can interact with Maia Chat by
 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
-    
+
+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. 
+
+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:
+
+    * You can rate the **correctness**, **completeness**, and **readability** of the provided answer.
+
+    * You can also provide **Additional feedback** if you want to. 
+
+      {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}} 
+
+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.
+
+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).
 #### Studio Pro Features
 
-Studio Pro has additional features which are indicated by the following:
+Maia Chat in Studio Pro has additional features which are indicated by the following:
 
 * 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 %}}
 
-1. 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. 
-
-2. Click the add feedback icon ({{% icon name="notes-paper-edit" %}}) to provide a more detailed feedback. A detailed **Feedback** section shows below the answer:
-
-    * You can rate the **correctness**, **completeness**, and **readability** of the provided answer.
-    * You can also provide **Additional feedback** if you want to. 
-
-        {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}} 
-
-3. 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.
-
-4. 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 10.7.0).
-
 ### Asking Follow-Up Questions
 
-In Studio Pro 10.8.0 and above, and in Mendix Portal, 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?*.
+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?*.
 
-#### Conversation History
+{{% alert color="info" %}}
 
-Maia Chat only keeps track of a conversation history within a session in Studio Pro or a session on a page in the Mendix Portal.
+Maia Chat only keeps track of a conversation history within a session in Studio Pro.
+
+{{% /alert %}}
 
 ## Keyboard Support
 
