Document Maia Plan

Author: NicoletaComan

content/en/docs/developerportal/_index.md

@@ -20,11 +20,69 @@ cascade:
 
 ## Creating an App {#create-app}
 
-Follow these steps to create a new app and start collaborating:
+There are two ways to create apps:
 
-1. In **Apps**, click **Create App** in the upper-right corner. A screen opens to guide you through the process.
+* Using Maia to plan and build your app.
+* Using a starter app template.
 
-2. Enter the following information for your app:
+The following sections describe the process for each option.
+
+### Creating an App with Maia
+
+{{% alert color="warning" %}}
+This feature is in Public Beta. For more information, refer to [Release Status](/releasenotes/release-status/).
+{{% /alert %}}
+
+Follow these steps to have Maia plan and generate an app for you:
+
+1. In **Apps**, click **Create App** in the upper right corner.
+
+2. Select **Plan & Build with Maia**. 
+
+3. In the **Project Context** text box, enter as much detail as possible about your future app. These are some details that you could add to help Maia generate an app for you:
+
+    * Describe your goals.
+    * Describe your targeted users.
+    * List out success criteria.
+    * Add requirements.
+    * Attach documents, sketches, images.
+
+4. Click **Generate Plan**. The **Project Scope** window is displayed, and Maia starts populating it with the proposed project scope. Once 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.
+    * **Success Criteria** – A list of criteria by which to measure the success of the app.     
+        You can remove criteria by hovering over them, then clicking the trash can icon.    
+        You can add new criteria by clicking **+ Add New Success Criteria**.
+    * **Target Users** – Cards corresponding to the app's target users, along with each user's goal.    
+        You can remove users or their goals by hovering over them, then clicking the trash can icon.    
+        You can add users by clicking **+ Add New User**.    
+        You can add user goals by clicking **+ Add New User Goal**.
+    * **Requirements** – The features that the app must have.     
+        You can remove features by hovering over them, then clicking the trash can icon.    
+        You can add new features by clicking **+ Add New Requirement**.
+
+    You can use the pane on the right to chat with Maia about your requirements for the new app.
+
+5. 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**.
+
+6. 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. Once populated, you can see the following information generated by Maia:
+
+* Cards corresponding to each epic which contributes to building the app.
+* Stories making up each epic.    
+    You can remove stories by hovering over them, then clicking the trash can icon.    
+    You can click the card itself to see the entire list of stories for an epic in the right side panel. For each story, click the context menu to edit or remove the story.
+
+
+### Creating an App from a Starter App Template
+
+Follow these steps to use a starter app:
+
+1. In **Apps**, click **Create App** in the upper right corner. 
+
+2. Select **Use a Starter App**. A screen opens to guide you through the process.
+
+3. Enter the following information for your app:
 
     * **App name** – Every app must have a name that abides by these requirements:
 
@@ -36,15 +94,15 @@ Follow these steps to create a new app and start collaborating:
 
     * **App icon** – Mendix has generated an icon for your app. You can change the color of the icon if you like. You can upload a custom icon in the [App Settings](/developerportal/general-settings/#general) page once you have created the app.
 
-3. Click **Next** to go to step 2.
+4. Click **Next** to go to step 2.
 
-4. Select a starter app template on which the app will be based. The most used starter app templates are displayed.    
+5. Select a starter app template on which the app will be based. The most used starter app templates are displayed.    
 
     Some templates offer multiple versions for you to choose from, which are displayed as selectable options. By default, the stable version is pre-selected.    
 
     If you want to choose a different starter app template than the ones displayed, click the **discover community starter apps** link at the top. This takes you to the Marketplace, where you can browse through all available starter app templates and select one that suits your needs.
 
-5. After selecting a starter app template, click **Create App**. Based on the starter app template you selected, it can take some time to set up the app, its repository, and access to the collaboration tools. After it is completed, the app is created.
+6. After selecting a starter app template, click **Create App**. Based on the starter app template you selected, it can take some time to set up the app, its repository, and access to the collaboration tools. After it is completed, the app is created.
 
 ## My Apps {#my-apps}