Merge pull request #10939 from mendix/yl-Maia-documentation-update-11-9

Maia Documentation Updates for 11.9

Author: MarkvanMents

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

@@ -39,14 +39,7 @@ Mendix AI Assistance (Maia) in Studio Pro has the following capabilities:
 Starting point for app creation:
 
 * **Start with Maia** - a starting point in Studio Pro that helps you to start the app development process. Based on a required text description and an optional image or PDF, it generates an app that includes a domain model, data management overview pages, test data, and a tailored homepage. For more information, see [Start with Maia](/refguide/start-with-maia/).
-* **Maia Make** - a unified conversational interface in Studio Pro that groups all AI-assisted development capabilities into a single chat experience. With this interface, everything happens in one place. Start a conversation, describe what you need, and Maia generates the necessary app artifacts—a new domain model, overview pages, or microflows, or explaining your app logic and pages. Below is a list of Maia Make Capabilities:
-
-    * **Domain model creation** - Describe your data structure and Maia creates the entities and associations you need.
-    * **Page generation** - Generate overview pages.
-    * **Microflow generation** - Generate microflows, enumerations, XPath constraints, and expressions.
-    * **MCP client** - Connect to compatible MCP Servers to leverage tools such as Playwright or Figma to improve the capabilities of Maia.
-    * **Document upload** - Upload a PDF or an image and you can ask Maia to use it in your app creation. 
-    * **User story linking** - Select an existing story in Studio Pro and Maia can help you realize it. 
+* **Maia Make** - a unified conversational interface in Studio Pro that groups all AI-assisted development capabilities into a single chat experience. With this interface, everything happens in one place. Start a conversation, describe what you need, and Maia generates the necessary app artifacts, such as a new domain model, pages, and microflows. You can also ask it to explain documents for you, including your app logic and pages. 
 
     This unified conversational interface is released in Studio Pro 11.8. For more information, see [Maia Make](/refguide/maia-make/).
 

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

@@ -15,21 +15,28 @@ Maia Make capabilities are grouped into a conversational interface, which is ava
 To use this interface and Maia Make capabilities, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
-Maia Make is a set of AI-assisted development capabilities in Studio Pro that are available through a unified conversational interface. Describe your requirements in natural language, and Maia generates development artifacts such as data structures, overview pages, and microflows. 
+Maia Make is a set of AI-assisted development capabilities in Studio Pro that are available through a unified conversational interface. Describe your requirements in natural language, and Maia generates development artifacts such as data structures, pages, and microflows. 
 
-You can also ask Maia to provide explanations of your existing logic and pages. Moreover, this interface allows you to integrate with external tools via MCP Servers (Playwright, Figma, and others) and it supports story-based development by generating app artifacts based on existing user stories.
+You can also ask Maia to provide explanations of your existing documents, such as microflows, workflows, and pages. Moreover, this interface allows you to integrate with external tools, such as Playwright and Figma, via MCP Servers, and it supports story-based development by generating app artifacts based on existing user stories.
 
 The key Maia Make capabilities are as follows:
 
 * Conversational assistance for general Mendix development queries
-* Logic and page explanations to clarify existing implementation details
-* Domain model generation from natural language descriptions
-* Overview page generation from natural language descriptions
-* Microflow generation including XPath constraints and expressions
-* External tool integration via compatible MCP Servers (such as Playwright, Figma)
+* Explanations of documents to clarify existing implementation details
+* Generation of documents from natural language descriptions, such as domain model, pages, and microflows
+* Integration with external tools, such as Playwright and Figma, via compatible MCP Servers
 * Story-based development to help realize existing user stories
-* PDF and image support to help Maia understand your requirements better
-* Add relevant logic and pages to the interface to give Maia a more desired context
+* Support for PDF and image inputs to help Maia better understand your requirements
+* Adding relevant documents, such as microflows and pages, to the interface to give Maia a more desired context
+* Editing existing documents, including renaming elements inside of documents such as entities, attributes, and microflow parameters
+* Removing elements from documents, enabling more advanced refactoring (in Studio Pro 11.9 and above)
+* Undoing changes generated on a per-document basis (in Studio Pro 11.9 and above)
+
+{{% alert color="info" %}}
+Support for workflows, view entities, enumerations, constants, modules, Java actions, and JavaScript actions was introduced in Studio Pro 11.9. 
+
+Java actions and JavaScript actions are read-only. Java actions can be used in microflows and can be explained. JavaScript actions can only be explained. 
+{{% /alert %}}
 
 ## Using Maia Make Capabilities
 
@@ -67,9 +74,11 @@ For more information on how each Maia Make capability work, refer to the followi
 * [Maia for Domain Model](/refguide/maia-for-domain-model/)
 * [Maia for Pages](/refguide/maia-for-pages/)
 * [Maia for Microflows](/refguide/maia-for-microflows/)
+* [Maia for Workflows](/refguide/maia-for-workflows/) (in Studio Pro 11.9 and above)
+* [[Maia for OQL](/refguide/maia-for-oql/)] (in Studio Pro 11.9 and above)
 * [Maia MCP Client](/refguide/maia-mcp/)
 
-In Studio Pro 11.8 and above, most of the features described in the documents above are available only through the chat interface. There are no separate entry points to these features in their respective editors. [Maia Explain](/refguide/maia-explain/) is an exception. You can still access this feature by right-clicking the documents (microflows or pages) in the **App Explorer** and the **Maia Explain** option is in the context menu.
+In Studio Pro 11.8 and above, most of the features described in the documents above are available only through the chat interface. There are no separate entry points to these features in their respective editors. [Maia Explain](/refguide/maia-explain/) is an exception. You can still access this feature by right-clicking the documents (for example, microflows or pages) in the **App Explorer** and the **Maia Explain** option is in the context menu.
 
 ## Read More
 

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

@@ -33,12 +33,14 @@ See below a list of Maia Chat's data sources:
 * [Mendix Blog](https://www.mendix.com/blog/)
 * [Mendix Medium](https://medium.com/mendix)
 * [Mendix Evaluation Guide](https://www.mendix.com/evaluation-guide/)
- 
-## Using Maia Chat in Studio Pro
 
-{{% alert color="info" %}}
+## Using Maia Chat
+
+### In Studio Pro 11.8 and Above
+
 In Studio Pro 11.8 and above, Maia Chat is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia Chat. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
-{{% /alert %}}
+
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, there are two ways to access Maia Chat in Studio Pro:
 
@@ -55,7 +57,7 @@ For more information on Maia Chat features in Studio Pro, see the sub-sections b
 
 If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can not get a good answer, please see the [Giving Feedback](#feedback) section below for information on how to let Mendix know.
 
-### Maia Chat Features in Studio Pro
+#### Maia Chat Features in Studio Pro
 
 After a question is sent to Maia Chat, you will see the following in the chat interface:
 
@@ -67,7 +69,7 @@ After a question is sent to Maia Chat, you will see the following in the chat in
 * A copy icon ({{% icon name="copy" %}}) which allows you to copy the given answer to a clipboard
 * Feedback icons
 
-#### Giving Feedback {#feedback}
+##### Giving Feedback {#feedback}
 
 Mendix encourages giving feedback on the answers generated by Maia Chat. Feedback will be used to further improve Maia Chat.
 
@@ -82,15 +84,15 @@ There are several ways to give feedback on the generated 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
 
 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 %}}
 
-#### New Chat
+##### New Chat
 
 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.
 

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

@@ -12,18 +12,20 @@ description: "Describes the features in Maia Explain."
 To use Maia Explain, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
-## Using Maia Explain in Studio Pro 11.8 and Above
+## Using Maia Explain
+
+### In Studio Pro 11.8 and Above
 
 In Studio Pro 11.8 and above, Maia Explain is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia Explain. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
 
 There are two ways to use Maia Explain:
 
-* Use the chat interface directly to get explanations of your microflows or pages.
-* In the App Explorer, right-click a microflow or a page to open its context menu, and click **Maia Explain**.
+* Use the chat interface directly to get explanations of your document (for instance, a microflow or a page).
+* In the App Explorer, right-click a document to open its context menu, and click **Maia Explain**.
 
-Nanoflows are not supported by Maia Explain in Studio Pro 11.8.
+Nanoflows are currently not supported by Maia Make.
 
-## Using Maia Explain in Studio Pro 11.7 and Below
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, Maia Explain is enabled by default. If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia Explain** checkbox.
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md

@@ -18,9 +18,11 @@ Maia for Domain Model helps you generate new [domain model](/refguide/domain-mod
 
 ## Using Maia for Domain Model
 
-{{% alert color="info" %}}
+### In Studio Pro 11.8 and Above
+
 In Studio Pro 11.8 and above, Maia for Domain Model is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Domain Model. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
-{{% /alert %}}
+
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, Maia for Domain Model is enabled by default. You can find it in the the toolbar of a domain model:
 
@@ -44,7 +46,7 @@ Maia for Domain Model does not support deleting items in the domain model. You c
 In this dedicated chat, only requests related to domain model will be properly handled. If you have other questions, close this chat and go back to the general [Maia Chat](/refguide/maia-chat/) interface.
 {{% /alert %}}
 
-### Best Practices for Text Input
+#### Best Practices for Text Input
 
 To achieve optimal results, provide context about your application by describing its main use cases, customer needs, or other relevant details. The more Maia knows about your application, the more tailored and accurate the generated domain model will be.
 
@@ -64,7 +66,7 @@ Below are examples of prompts you can use to ask Maia for explanations or sugges
 * I want to make the domain model more efficient. Can you suggest optimizations?
 * Could you identify any potential issues with this domain model and recommend solutions?
 
-### Attachment Requirements {#attachment-requirements}
+#### Attachment Requirements {#attachment-requirements}
 
 In Studio Pro 11.1 and above, Maia for Domain Model supports adding a maximal of one image and one PDF as attachments. The attachments must meet the following requirements:
 
@@ -73,17 +75,12 @@ In Studio Pro 11.1 and above, Maia for Domain Model supports adding a maximal of
 * The image resolution must be no greater than 3840 × 2400 pixels.
 * The PDF file size must not exceed 1024 KB.
 
-## Limitations {#limitation}
-
-Maia for Domain Model has some limitations.
-
-### Enumeration Generation
-
-It can only generate an attribute of type Enumeration if there is an existing enumeration in the module to refer to.
+#### Limitations {#limitation}
 
-### Generalization Not Supported
+Maia for Domain Model has the following limitations:
 
-It cannot set [generalization](/refguide/generalization-and-association/) for an entity.
+* It can only generate an attribute of type Enumeration if there is an existing enumeration in the module to refer to.
+* It cannot set [generalization](/refguide/generalization-and-association/) for an entity.
 
 ## Read More
 

…ing/mendix-ai-assistance/maia-for-oql.md …-ai-assistance/maia-make/maia-for-oql.mdcontent/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-oql.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-oql.md content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-oql.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-oql.md

@@ -1,7 +1,7 @@
 ---
 title: "Maia for OQL"
 url: /refguide/maia-for-oql/
-weight: 70
+weight: 78
 description: "Describes the features in Maia for OQL Generation."
 ---
 
@@ -15,15 +15,21 @@ Maia for OQL is a powerful feature that enables you to generate and manage OQL (
 
 ## Using Maia for OQL
 
-To enable this feature, navigate to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for OQL Generation**.
+### In Studio Pro 11.9 and Above
+
+In Studio Pro 11.9 and above, Maia for OQL is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for OQL. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
+
+### In Studio Pro 11.8 and Below
+
+In Studio Pro 11.8 and below, to enable Maia for OQL, navigate to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for OQL Generation**.
 
 Once enabled, you can access it from the toolbar in the **OQL Editor**:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-oql-generator/maia-for-oql-button.png" max-width=80% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-oql-generator/maia-for-oql-button.png" max-width=80% >}}
 
 Clicking **Maia for OQL** opens a dedicated chat interface on the right side of Studio Pro, under the **Maia** tab:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-oql-generator/maia-pane-for-oql-generator.png" max-width=42% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-oql-generator/maia-pane-for-oql-generator.png" max-width=42% >}}
 
 To use Maia for OQL, simply describe the data you need. For example, if you type *Show all active orders with customer names*, Maia will generate the most relevant OQL query based on the data available in the same module.
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md

@@ -18,9 +18,15 @@ Maia for Pages helps you generate a [page](/refguide/page/) by adding and config
 
 ## Using Maia for Pages
 
-{{% alert color="info" %}}
+### In Studio Pro 11.8 and Above
+
 In Studio Pro 11.8 and above, Maia for Pages is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Pages. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
-{{% /alert %}}
+
+In Studio Pro 11.8, only overview pages can be generated.
+
+In Studio Pro 11.9 and above, custom pages can be generated from scratch and  modifying existing pages is also supported. Moreover, local variables, additional data sources, client actions, XPath constraints, and expressions are supported.
+
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, to enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**.
 
@@ -46,7 +52,7 @@ On pages that have already been created, either by Maia for Pages or manually, y
 In this dedicated chat, only requests related to Pages will be properly handled. If you have other questions, close this chat and go back to the general [Maia Chat](/refguide/maia-chat/) interface.
 {{% /alert %}}
 
-### Best Practices for Text Input
+#### Best Practices for Text Input
 
 To achieve optimal results, provide context about your page by describing its main use cases, customer needs, or other relevant details. The more Maia knows about your page, the more tailored and accurate the generated page will be.
 
@@ -68,13 +74,13 @@ Below are examples of prompts you can use to ask Maia to make further edits or r
 * How can I make this page more user-friendly or visually appealing?
 * Could you suggest ways to optimize the performance of this page?
 
-### Best Practices for Image Input
+#### Best Practices for Image Input
 
 The image size is limited to 512 KB. Make sure to select a clear image to help Maia better understand your request. For example, you can provide a screenshot, a photo, a design mock-up, or a close-up picture of a drawing. Avoid heavily compressed or low quality images, as these may result in the loss of important details.
 
 Keep in mind that Maia analyzes only the structure of the image. The theming of your app, such as the color scheme, will not be changed. This can cause some differences between the provided image and the generated page.
 
-## Limitation {#limitation}
+### Limitation {#limitation}
 
 Maia for Pages does not support all widgets.