Merge pull request #9566 from MendixBart/pe/PAG-2653-update-page-generation-docs

Update Maia for Pages docs for Mendix 11 beta 2.

Author: MariaShaposhnikova

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

@@ -14,7 +14,7 @@ aliases:
 To use Maia for Pages, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
-Maia for Pages helps you generate a [page](/refguide/page/) as well as explain and provide further improvements. It helps you add and configure widgets based on text input and optional image input. After a page is generated, you can continue in the same session to ask Maia for further improvements and explanations. It has some limitations. For example, it is currently intended only for use with empty pages. Using it on an existing page results in the removal of all existing widgets on that page. For more details, see the [Limitations](#limitation) section below.
+Maia for Pages is an AI-powered tool that you can use for generating a [page](/refguide/page/) as well as explaining and providing further improvements. It helps you add and configure widgets based on text input and optional image input. It can also be used to edit or remove existing widgets. You can ask Maia for further improvements and explanations. For information on the current limitations of Maia for Pages, see the [Limitations](#limitation) section below.
 
 ## Using Maia for Pages
 
@@ -36,7 +36,7 @@ Describe your page or its main goals in the chat. Maia uses this information to
 
 You can also supplement text input with an image. Maia uses the image to interpret your request better. For example, it can recognize the layout of a page from the image and replicate it. The image can be a screenshot, photo, wireframe, or drawing. With text input, you can also specify differences between the provided image and how you would like the generated page to appear. For example, you might write: *Generate a page based on this image, but change the header to Welcome.*
 
-After a page is generated, you can continue asking Maia in the same session to further improve the page and provide explanations.
+On pages that have already been created, either by Maia for Pages or manually, you can ask Maia to further improve the page and provide explanations. For example, you can add extra widgets, edit widgets by changing their properties, or remove widgets.
 
 {{% alert color="info" %}}
 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.
@@ -46,24 +46,24 @@ In this dedicated chat, only requests related to Pages will be properly handled.
 
 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.
 
-Below are some examples of prompts you can use as a starting point:
+Below are examples of prompts you can use as a starting point:
 
 * The page will be used to ...
 * I need a page to be able to edit my entity ...
 * Create a page based on the image.
 * Base the page on the image, but change ... to ...
 
-Below are some examples of prompts you can use to ask Maia for further explanations or suggestions to improve the generated page:
+Below are examples of prompts you can use to ask Maia to make further edits or request suggestions for improving a page:
 
 * Can you add a button called `BUTTON_NAME` to the page?
 * I want an area on the page where users can ...
+* Make the save button a primary button.
+* Change the page header to use Heading 1.
+* Remove the ... widget.
+* Delete all widgets on the page.
 * How can I make this page more user-friendly or visually appealing?
 * Could you suggest ways to optimize the performance of this page?
 
-{{% alert color="warning" %}}
-Requests for improvements or explanations currently only work within the same session where the page is generated. If you close the session and start a new session on that page, any attempts to make changes to the page will result in the removal of existing widgets.
-{{% /alert %}}
-
 ### 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.
@@ -74,12 +74,6 @@ Keep in mind that Maia analyzes only the structure of the image. The theming of
 
 Maia for Pages has some limitations.
 
-### Empty Pages Only
-
-Maia for Pages is currently intended only for use with empty pages. Using it on an existing page results in the removal of all existing widgets on that page. 
-
-Requests for improvements and explanations currently only work within the same session where a page has been generated. Once the session is closed, Maia for Pages loses the context. Any attempts to make changes to that page in a new session will also result in the removal of all existing widgets.
-
 ### Supported Widgets
 
 Not all widgets are supported. Currently the following widgets are supported: