diff --git a/content/en/docs/developerportal/maia-plan.md b/content/en/docs/developerportal/maia-plan.md index 7d3d6346ec8..eeb93d94f3d 100755 --- a/content/en/docs/developerportal/maia-plan.md +++ b/content/en/docs/developerportal/maia-plan.md @@ -9,17 +9,17 @@ weight: 3 You can use Maia Plan to plan and generate an app. This page describes how to provide project context, review and refine the generated project scope, and approve the solution proposal to initiate app development. -{{< figure src="/attachments/developerportal/maia/maia-create-app.png" alt="Plan and build with Maia" max-width=50% >}} + ## Creating an App with Maia Plan Go through the steps in the following sections to have Maia Plan create an app for you. -### Adding Project Details +### Adding Project Context 1. In **Apps**, click **Create App** in the upper right corner. -2. Select **Plan & Build with Maia**. +2. Select **Plan & Build**. The **Plan & Build with Maia** window is displayed. 3. In the **Project Context** text box, enter as much detail as possible about your future app. Include the following information to help Maia generate an accurate app plan: @@ -29,12 +29,14 @@ Go through the steps in the following sections to have Maia Plan create an app f * Add requirements. * Attach documents, sketches, images. -### Generating the Project Scope +4. Click **Generate Plan**. -1. Once you have added all the preliminary details, click **Generate Plan**. The **Project Scope** window is displayed, and Maia starts populating it with the proposed project scope. +### Defining the Scope + +1. After clicking **Generate Plan**, the **Define Scope** window is displayed, and Maia starts populating it with the proposed project scope. The app plan becomes available on the **Apps** page as soon as you click **Generate Plan** at the beginning of the workflow. As such, you can go back to the plan at any time after you leave it, and you can already add team members to the app. - Once the **Project Scope** window is populated, you can see the following information generated by Maia: + Once the **Define Scope** window is populated, you can see the following information generated by Maia: * **Goal** – A description of what you want to achieve through the app. You can edit this description. @@ -60,25 +62,32 @@ Go through the steps in the following sections to have Maia Plan create an app f You can use the pane on the right to chat with Maia about your requirements for the new app. -2. Once you review the project scope and make any changes you deem necessary, click **Approve Project Scope** in the top right of the page. The status of the project scope changes from **Draft** to **Approved**. +2. Once you review the project scope and make any changes you deem necessary, click **Approve to Generate**. + You can also click **Save and Exit** to save all the changes you have made so far and leave the flow. -### Generating the Solution Proposal +### Generating the Plan -If you agree with the project scope, click **Generate Solution** in the top right of the page. The **Solution Proposal** window is displayed, and Maia starts populating it with the proposed project scope. -While the solution proposal is being generated, as well as after it's displayed, the **Project Scope** is locked. If you want to make changes to it, you can click the lock icon to unlock it. -Once the **Solution Proposal** window is populated, you can see the following information generated by Maia: +1. After clicking **Approve to Generate**, the **Generate Plan** window is displayed, and Maia starts populating it with the proposed plan based on the project scope. + Once the **Generate Plan** window is populated, you can see the following information generated by Maia: -* Cards corresponding to each epic which contributes to building the app. - You can remove epics by hovering over them, then clicking the trash can icon. - Click the card itself to: + * Cards corresponding to each epic which contributes to building the app. + You can remove epics by hovering over them, then clicking the trash can icon. + Click the card itself to: - * See the entire list of stories for an epic in the right side panel. - * Edit the description or details of the epic. + * See the entire list of stories for an epic in the right side panel. + * Edit the description or details of the epic. - You can perform the following actions on each story: + You can perform the following actions on each story: + + * To see the full details of a story or to edit it, click the three-dot menu, then select **Edit**. + * To remove a story, click the three-dot menu, then select **Delete**. + +2. While the project plan is being generated, you have these options: + + * **Previous** – Click this button to go back to the **Define Scope** window. Any changes you have made are saved. + * **Save and Exit** – Save all the changes you have made so far and leave the flow. - * To see the full details of a story or to edit it, click the three-dot menu, then select **Edit**. - * To remove a story, click the three-dot menu, then select **Delete**. + Once the project plan is fully generated and you have made any necessary changes to it, click **Start Building**. #### Recommended Marketplace Components {#recommender} @@ -98,9 +107,11 @@ If your company does not have company-approved components, Maia returns the foll * platform-supported components * all Private Marketplace components -### Opening the App +### Starting the Development -Once you are happy with Maia's suggested project plan, click **Open in Studio Pro** in the top right of the page. This opens Studio Pro, where you can continue working on the new app. Note that, at the moment, Studio Pro does not take into account [recommended components](#recommender). -For details, refer to [Maia Make](/refguide/maia-make/) in the Studio Pro documentation. +After clicking **Start Building**, the **Start Development** window is displayed. This provides you with the following options: -You can also click **Open in Planning** to open the **Planning** window of the new app, which includes all the project's stories. Note that, if you click **Open in Planning** before Maia is done [finding recommendations](#recommender), recommended components are not displayed in the **Planning** window. +* **Prioritize in Planning Board** – Click this button to open the **Planning** window of the new app, which includes all the project's stories. + Note that, if you click **Open in Planning** before Maia is done [finding recommendations](#recommender), recommended components are not displayed in the **Planning** window. +* **Open in Studio Pro** - Click this button to open Studio Pro, where you can continue working on the new app. Note that, at the moment, Studio Pro does not take into account [recommended components](#recommender). + For details, refer to [Maia Make](/refguide/maia-make/) in the Studio Pro documentation. diff --git a/content/en/docs/releasenotes/developer-portal/2026.md b/content/en/docs/releasenotes/developer-portal/2026.md index 1da3c8006b8..fa553f7ad71 100644 --- a/content/en/docs/releasenotes/developer-portal/2026.md +++ b/content/en/docs/releasenotes/developer-portal/2026.md @@ -8,6 +8,19 @@ weight: 1 ## April 2026 +### April 23, 2026 + +#### Improvements + +* In an effort to provide a seamless app creation experience, we have updated the [Maia Plan](/developerportal/maia-plan/) project creation flow. Everything works the same, but the step layout and progression are now aligned to the general Mendix Portal experience that you might already be used to. + +#### Fixes + +* We are now displaying explanatory error messages in the following scenarios: + + * If generating epics takes too long. + * If large requirements documents do not process correctly. + ### April 2, 2026 #### New Features diff --git a/layouts/partials/landingpage/latest-releases.html b/layouts/partials/landingpage/latest-releases.html index d6485a41f0e..5e4af6a6480 100644 --- a/layouts/partials/landingpage/latest-releases.html +++ b/layouts/partials/landingpage/latest-releases.html @@ -10,7 +10,7 @@
April 2, 2026
+April 23, 2026