Review the "Maia Make Capabilities" index page and consistency check overall

Yiyun333 · Yiyun333 · commit e5e3131e5c3b · 2026-05-20T13:55:57.000+02:00
diff --git a/content/en/docs/refguide/mendix-ai-assistance/_index.md b/content/en/docs/refguide/mendix-ai-assistance/_index.md
@@ -45,7 +45,7 @@ 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, 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/).
+    This unified conversational interface was released in Studio Pro 11.8. For more information, see [Maia Make](/refguide/maia-make/).
 
 Guidance:
 
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md
@@ -10,33 +10,57 @@ description_list: true
 ## Introduction 
 
 {{% alert color="info" %}}
-Maia Make capabilities are grouped into a conversational interface, which is available in Studio Pro 11.8 and above.
+Maia Make capabilities are available in Studio Pro 11.8 and above.
 
-To use this interface and Maia Make capabilities, an internet connection and signing in to Studio Pro are required.
+To use 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, pages, and microflows. 
 
 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:
+## Maia Capabilities Overview
 
-* Conversational assistance for general Mendix development queries
-* 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
-* 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)
+The following table lists the major Maia Make capabilities, their descriptions, and the Studio Pro versions in which they were introduced as part of Maia Make:
 
-{{% alert color="info" %}}
-Support for workflows, view entities, enumerations, constants, modules, Java actions, and JavaScript actions was introduced in Studio Pro 11.9. In this version, Java actions are read-only; they can be used in microflows and explained. JavaScript actions can only be explained.
+| Capability | Description | Available in Maia Make from |
+| --- | --- | --- |
+| [Maia Chat](/refguide/maia-chat/) | Answers questions about all aspects of Mendix development. | Studio Pro 11.8 |
+| [Maia Explain](/refguide/maia-explain/) | Explains the purpose and logic of existing documents such as microflows and pages. | Studio Pro 11.8 |
+| [Maia for Domain Model](/refguide/maia-for-domain-model/) | Generates and explains domain models. | Studio Pro 11.8 |
+| [Maia for Pages](/refguide/maia-for-pages/) | Generates pages and widgets from text or image input. | Studio Pro 11.8 |
+| [Maia for Microflows](/refguide/maia-for-microflows/) | Generates microflow logic from natural language descriptions. | Studio Pro 11.8 |
+| [Maia for Workflows](/refguide/maia-for-workflows/) | Generates workflows from natural language or image input. | Studio Pro 11.9 |
+| [Maia for OQL](/refguide/maia-for-oql/) | Generates and manages OQL queries. | Studio Pro 11.9 |
+| [Maia MCP Client](/refguide/maia-mcp/) | Connects Maia to external MCP servers, giving it access to third-party tools during chat. | Studio Pro 11.8 |
+| [Studio Pro MCP Server](/refguide/studio-pro-mcp-server/) | Exposes Studio Pro as an MCP server for use by external AI tools. | Studio Pro 11.10 |
+| [Maia Web Fetch](/refguide/maia-web-fetch/) | Fetches and reads content from public websites and APIs during chat. | Studio Pro 11.10 |
+| [Maia Agent Skills](/refguide/maia-agent-skills/) | Extends Maia with reusable, domain-specific knowledge that applies automatically when relevant. | Studio Pro 11.11 |
+
+In addition to the core capabilities listed above, Maia Make includes the following features:
+
+| Capability | Description | Available in Maia Make from |
+| --- | --- | --- |
+| Story-based development | Generates app artifacts based on existing user stories to support story-driven development workflows. | Studio Pro 11.8 |
+| PDF/image support | Allows you to provide PDFs and images as input to help Maia better understand your requirements. | Studio Pro 11.8 |
+| Adding documents as context | Lets you add relevant documents, such as microflows and pages, to provide Maia with additional context during chat. | Studio Pro 11.8 |
+| Editing existing documents | Enables Maia to modify existing documents, including renaming elements such as entities, attributes, and microflow parameters. | Studio Pro 11.8 |
+| Removing elements | Allows Maia to remove elements from documents to support more advanced refactoring tasks. | Studio Pro 11.9 |
+| Undo support | Allows you to undo Maia-generated changes on a per-document basis. | Studio Pro 11.9 |
+
+### Other Supported Document Types
+
+In Studio Pro 11.9, support for enumerations, constants, modules, Java actions, and JavaScript actions was added. In this version, Java actions are read-only; they can be used in microflows and explained. JavaScript actions can only be explained.
 
 Starting with Studio Pro 11.10, Maia can generate JavaScript actions, add parameters to existing ones, and create or update the JavaScript file associated with a JavaScript action.
-{{% /alert %}}
+
+### Support for Folder Structure
+
+In Studio Pro 11.10 and above, Maia understands and leverages the existing folder structure within your Mendix applications for all documents except for pages. This enables Maia to:
+
+* Organize documents into folders: When creating new documents, Maia can place them directly into relevant folders, respecting your project's organization.
+* Follow existing folder structures: Maia works within your established folder hierarchy, making it easier to maintain consistency.
+* Adhere to Mendix best practices: Maia can help organize documents according to the standard Mendix best practices for folder structure. For detailed guidance on optimal organization of folders, refer to the [Folder Structure](/refguide/naming-convention-best-practices/#folder-structure) section in *Naming Convention Best Practices*.
 
 ## Using Maia Make Capabilities
 
@@ -67,30 +91,6 @@ The conversational interface includes the following options:
 * **{{% icon name="paperclip" %}} Add** (Image, Story, PDF) - With this option, you can attach images, PDFs, or user stories to help Maia understand your requirements better.
 * **Add file to Maia Chat** (@ icon) - It allows you to add certain logic or pages to Maia as context. You can also access this option by right-clicking the documents (microflows or pages) in the **App Explorer** and it appears in the context menu.
 
-#### Support for Folder Structure
-
-In Studio Pro 11.10 and above, Maia understands and leverages the existing folder structure within your Mendix applications for all documents except for pages. This enables Maia to:
-
-* Organize documents into folders: When creating new documents, Maia can place them directly into relevant folders, respecting your project's organization.
-* Follow existing folder structures: Maia works within your established folder hierarchy, making it easier to maintain consistency.
-* Adhere to Mendix best practices: Maia can help organize documents according to the standard Mendix best practices for folder structure. For detailed guidance on optimal organization of folders, refer to the [Folder Structure](/refguide/naming-convention-best-practices/#folder-structure) section in *Naming Convention Best Practices*.
-
-For more information on how each Maia Make capability work, refer to the following documents:
-
-* [Maia Chat](/refguide/maia-chat/)
-* [Maia Explain](/refguide/maia-explain/)
-* [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/)
-* [Studio Pro MCP Server](/refguide/studio-pro-mcp-server/)
-* [Maia Web Fetch](/refguide/maia-web-fetch/)
-* [Maia Agent Skills](/refguide/maia-agent-skills/)
-
-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
 
 * [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-agent-skills.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-agent-skills.md
@@ -2,15 +2,15 @@
 title: "Maia Agent Skills"
 linktitle: "Agent Skills"
 url: /refguide/maia-agent-skills/
-weight: 88
+weight: 95
 description: "Describes how to create and manage agent skills that equip Maia with domain-specific knowledge, applied automatically whenever relevant."
 #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
 
 {{% alert color="info" %}}
-This feature is released as part of [Maia Make](/refguide/maia-make/) capabilities in Studio Pro 11.11 and above.
+This feature was released as part of [Maia Make](/refguide/maia-make/) capabilities in Studio Pro 11.11.
 
 To use Maia Agent Skills, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-for-microflows.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-for-microflows.md
@@ -7,7 +7,9 @@ description: "Describes the features in Maia for Microflows."
 ## Introduction
 
 {{% alert color="info" %}}
-This feature is released as part of [Make Make](/refguide/maia-make/) capabilities in Studio Pro 11.8. 
+This feature was released as part of [Make Make](/refguide/maia-make/) capabilities in Studio Pro 11.8.
+
+To use Maia for Microflows, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
 Maia for Microflows is an AI-powered capability that is available when using [Maia Make](/refguide/maia-make/) in Studio Pro. Maia Make is a unified conversational interface within Studio Pro that consolidates all AI-assisted development capabilities into a single chat experience. 
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-for-oql.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-for-oql.md
@@ -8,7 +8,7 @@ description: "Describes the features in Maia for OQL Generation."
 ## Introduction
 
 {{% alert color="info" %}}
-An internet connection and signing in to Studio Pro are required to use Maia for OQL.
+To use Maia for OQL, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
 Maia for OQL is a powerful feature that enables you to generate and manage OQL (Object Query Language) queries through an intuitive interface. It is designed to simplify query creation and reduce manual effort. Currently it has some limitations. For more details, see the [Limitations](#limitations) section below.
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md
@@ -10,7 +10,7 @@ description: "Describes the features in Maia MCP Client."
 ## Introduction
 
 {{% alert color="info" %}}
-This feature is released as part of [Maia Make](/refguide/maia-make/) capabilities in Studio Pro 11.8. 
+This feature was released as part of [Maia Make](/refguide/maia-make/) capabilities in Studio Pro 11.8. 
 
 To use Maia MCP Client, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-web-fetch.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-web-fetch.md
@@ -10,7 +10,7 @@ description: "Describes Maia's web fetch capability for retrieving content from
 ## Introduction
 
 {{% alert color="info" %}}
-This feature is available in Studio Pro 11.10 and above. 
+This feature was released as part of [Maia Make](/refguide/maia-make/) capabilities in Studio Pro 11.10. 
 
 To use Maia Web Fetch, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md
@@ -10,7 +10,7 @@ description: "Describes the features in Studio Pro MCP Server."
 ## Introduction
 
 {{% alert color="info" %}}
-This feature is available in Studio Pro 11.10 and above. 
+This feature was released in Studio Pro 11.10. 
 
 To use Studio Pro MCP Server, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
