Merge branch 'main' into pages-PR-260-related

Author: tapanm-MSFT

powerapps-docs/maker/TOC.yml

@@ -622,6 +622,8 @@
           href: ./canvas-apps/show-current-user.md
         - name: Connect lists using lookups
           href: ./canvas-apps/sharepoint-lookup-fields.md
+        - name: Formula repair in canvas apps (preview)
+          href: common/formula-repair.md
         - name: Working with flows
           items:
           - name: Use Power Automate pane 
@@ -1312,6 +1314,8 @@
             href: ./model-driven-apps/model-app-page-issues.md
           - name: Use monitor to troubleshoot custom pages
             href: ./model-driven-apps/monitor-page-checker.md
+          - name: Formula repair in custom pages (preview)
+            href: common/formula-repair.md
         - name: Create, add, or remove forms and views
           href: ./model-driven-apps/create-add-remove-forms-views-dashboards.md 
       - name: Work with views

powerapps-docs/maker/canvas-apps/git-version-control.md

@@ -5,7 +5,7 @@ author: gregli-msft
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 08/30/2022
+ms.date: 09/30/2022
 ms.subservice: canvas-maker
 ms.author: gregli
 search.audienceType:
@@ -144,7 +144,7 @@ Since this feature is experimental, we welcome your feedback. The following list
 - If you open a non git connected app (for example, **App A**) from within a git connected app (for example, **App B**) (File > Open) and try to connect **App A** to a repository, **App A**'s git version control parameters will be the same as **App B**. When this happens, refresh your page and then try connecting **App A** to the repository again.
 - This feature does not support renaming of custom components.
 - If you see a message about the app being open for editing by another user, ask the referenced user to refresh the app. Afterwards, refresh your app to remove the lock.
-- This feature isn't compatible with [Test Studio tests](test-studio.md).
+- This feature is not compatible with [Test Studio tests](test-studio.md) and [custom pages for model-driven apps](../model-driven-apps/model-app-page-overview.md)
 
 ## Feedback to the community forum
 

powerapps-docs/maker/common/formula-repair.md

@@ -0,0 +1,70 @@
+---
+title: "Formula repair in Power Apps (preview) | MicrosoftDocs"
+description: Understand how to enable and use formula repair in Power Apps
+ms.custom: ""
+ms.date: 09/30/2022
+ms.reviewer: tapanm-msft
+ms.topic: overview
+author: norliu
+ms.subservice: common
+ms.author: norliu
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+contributors:
+  - tapanm-msft
+  - norliu
+---
+
+# Formula repair in Power Apps (preview)
+
+[This article is pre-release documentation and is subject to change.]
+
+When writing [Power Fx](/power-platform/power-fx/overview) formulas, errors are often unavoidable. And it's time-consuming to troubleshoot and fix. Power Apps Formula repair will automatically generate and fix suggestions for you when there's a formula error.
+
+## Enable formula repair
+
+Formula repair feature is available for [canvas apps](/power-apps/maker/canvas-apps/getting-started) and [custom pages](/power-apps/maker/model-driven-apps/model-app-page-overview).
+
+Once you have Power Apps Studio open, go to the top menu bar, and select **Settings** > **Upcoming features** > **Experimental**. You'll see the toggle for **Formula repair** feature. Select the toggle to turn the feature on to experience the advantage of automatic formula checks, and suggestions. 
+
+:::image type="content" source="media/formula-repair/setting.png" alt-text="Formula repair - feature.":::
+
+> [!IMPORTANT]
+> - This is an experimental feature.
+> - [!INCLUDE[cc_preview_features_definition](../../includes/cc-preview-features-definition.md)]
+
+## Use formula repair
+
+Once you have the focus inside the formula bar, if the formula has any errors that the formula repair feature finds suggestions for, you'll see a red dot next to the **fx** icon.
+
+When you select this red dot, you'll be able to see suggested fix for your formula. After confirming the suggested change, select **Apply** to apply the change to your formula and fix the formula error.
+
+For example, the following usage shows a typo when entering the name of the label from `Label1` to `Lable1`. The formula repair feature recognizes this mistake, and suggests the change. Upon confirming and applying the change, the error is fixed.
+
+:::image type="content" source="media/formula-repair/example-repair-process.png" alt-text="Example of Label.Text.":::
+
+## Scope of error discovery and suggestions
+
+Several types of errors are discovered and suggested as a fix.
+
+1. Missing parenthesis and missing quotes.
+
+1. Typos, similar to the example for the label control shown earlier in this article.
+
+1. Misuse of delimiters and missing operators.
+
+    Example of a formula using a comma (",") instead of a semicolon (";"):
+
+    :::image type="content" source="media/formula-repair/submitform.png" alt-text="Example of SubmitForm.":::
+
+    Example of a formula with a missed reference to a comma (","):
+
+    :::image type="content" source="media/formula-repair/complex-formula.png" alt-text="Example of complex formula.":::
+
+## Limitations
+
+- Formula repair won't be able to determine the expected values when you enter a complete incorrect control name. For example, if your control name is `MyLabel` and you try to enter `WrongLabel`. In this situation, formula repair feature won't be able to determine and suggest you to use the formula to reference `MyLabel` instead of `WrongLabel`.
+
+- Formula repair won't trigger if your formula has only warnings, or isn't showing any errors (even when the formula is incorrect).

powerapps-docs/maker/common/media/formula-repair/complex-formula.png

@@ -4,7 +4,7 @@ description: "This first run tutorial shows you how to build a model-driven app
 keywords: ""
 ms.date: 04/07/2022
 ms.custom: 
-ms.topic: getting-started
+ms.topic: conceptual
 applies_to: 
   - "Dynamics 365 (online)"
   - "Dynamics 365 Version 9.x"

powerapps-docs/maker/common/media/formula-repair/example-repair-process.png

@@ -104,3 +104,4 @@ Try the Power Apps [community](https://community.powerapps.com).
 
 
 [!INCLUDE[footer-include](../includes/footer-banner.md)]
+