Merge branch 'main' into updates

Author: tapanm-MSFT

.acrolinx-config.edn

@@ -1,7 +1,14 @@
-{:allowed-branchname-matches ["^main$"]
+{:allowed-branchname-matches ["main"]
  :allowed-filename-matches ["(?i)powerapps-docs/(?:(?!developer/data-platform/reference/entities))"]
- :guidance-profile "dc59e3ef-24fd-46d7-9156-0491aaae6bef" ;; Profile ID for "BAG-specific" 
  :use-skip-label true
+ :targets
+ {
+     :scores
+     {
+         :qualityscore 80
+     }
+ } 
+ :guidance-profile "66710a49-7773-43f4-b6d8-66b63b5e431f" ;; testing March 2023 updated guidelines - BAG
  :acrolinx-check-settings
  {
   "languageId" "en"
@@ -13,4 +20,19 @@
                         ]
   "termSetNames" ["BAG" "Microsoft" "Products"]
  }
+ 
+ :template-header
+ "
+## Acrolinx score
+ 
+**A minimum total score of 80 is required. The total score is an average of the subscores.**
+Select **Total score** to review the Acrolinx scorecard for your article. Try to increase your individual scores, ex. Correctness. Your article will be clearer and more consistent with Microsoft standards.
+ 
+| Article | **Total score**<br />**Required: 80** | Word and phrases<br />(Brand, terms)<br />Preferred: 100 | Correctness<br />(Spelling, grammar)<br />Preferred: 100 | Clarity<br />(Readability)<br />Preferred: 80 |
+|---------|:------------------------------------:|:--------------------------------------------------------:|:--------------------------------------------------------:|:---------------------------------------------:|
+"
+
+ :template-change
+ "| ${s/status} ${s/file} | [${acrolinx/qualityscore}](${acrolinx/scorecard}) | ${acrolinx/scores/words_and_phrases}  | ${acrolinx/scores/correctness}  | ${acrolinx/scores/clarity}  |
+"
 }

.openpublishing.publish.config.json

@@ -71,7 +71,13 @@
         "master": "master",
         "live": "master"
       }
-    }
+    },
+    {
+      "path_to_root": "shared-content",
+      "url": "https://github.com/MicrosoftDocs/powerapps-docs-pr",
+      "branch": "main",
+      "branch_mapping": {}
+    }   
   ],
   "branch_target_mapping": {
     "live": [
@@ -128,4 +134,4 @@
     }
   ],
   "need_generate_intellisense": false
-}
+}

.openpublishing.redirection.json

@@ -0,0 +1,5 @@
+{
+    "githubPullRequests.ignoredPullRequestBranches": [
+        "main"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.8 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+
+If you prefer to submit without logging in, send email to [[email protected]](mailto:[email protected]).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The ___location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

SECURITY.md

@@ -1,4 +1,4 @@
-- name: Docs
+- name: Learn
   href: /
   topicHref: /
   items:
@@ -10,43 +10,9 @@
       tocHref: /power-apps/
       topicHref: /power-apps/
       items:
-      # Adding Create app for each type of app
-      - name: Create apps
-        tocHref: /power-apps/maker/data-platform/
-        topicHref: /power-apps/maker/index
-      - name: Create apps
-        tocHref: /power-apps/maker/model-driven-apps/
-        topicHref: /power-apps/maker/index     
-      - name: Create apps
-        tocHref: /power-apps/maker/canvas-apps/
-        topicHref: /power-apps/maker/index       
-      #  Make sure Create apps appears for topics in developer folder 
-      - name: Create apps
+      - name: Dataverse
         tocHref: /power-apps/developer/data-platform/
-        topicHref: /power-apps/maker/index
-        items: 
-        - name: Dataverse
-          tocHref: /power-apps/developer/data-platform/
-          topicHref: /power-apps/maker/data-platform/index          
-          items:
-          - name: Developer
-            tocHref: /power-apps/developer/data-platform/
-            topicHref: /power-apps/developer/data-platform/index
-            items:
-            - name: Organization Service
-              tocHref: /power-apps/developer/data-platform/org-service/
-              topicHref: /power-apps/developer/data-platform/org-service/index
-            - name: Web API
-              tocHref: /power-apps/developer/data-platform/webapi/
-              topicHref: /power-apps/developer/data-platform/webapi/index
-      - name: Create apps
-        tocHref: /power-apps/developer/model-driven-apps/
-        topicHref: /power-apps/maker/index
-        items:
-        - name: Model-driven apps
-          tocHref: /power-apps/developer/model-driven-apps/
-          topicHref: /power-apps/maker/model-driven-apps/index      
-          items:
-          - name: Developer
-            tocHref: /power-apps/developer/model-driven-apps/
-            topicHref: /power-apps/developer/model-driven-apps/index    
+        topicHref: /power-apps/developer/data-platform/
+      - name: Dataverse
+        tocHref: /power-apps/maker/data-platform/
+        topicHref: /power-apps/maker/data-platform/

powerapps-docs/breadcrumb/toc.yml

@@ -5,7 +5,6 @@ ms.date: 11/17/2022
 ms.topic: overview
 author: sericks007
 ms.author: sericks
-manager: tapanm-msft
 ms.reviewer: 
 ms.custom: 
 ms.collection: 
@@ -14,13 +13,11 @@ ms.collection:
 
 # Requirements for cards
 
-[!INCLUDE[cards_preview_notice](includes/preview-include.md)]
-
-This article contains information on requirements for cards to show up and work as expected.
+This article contains information about requirements for cards to show up and work as expected.
 
 ## Environment requirements
 
-Cards are available in environments with Dataverse.
+Cards are available in environments with Microsoft Dataverse.
 
 The table below shows the environment regions cards are supported in.
 
@@ -35,8 +32,8 @@ The table below shows the environment regions cards are supported in.
 | India | Yes |
 | Canada | Yes |
 | United Kingdom | Yes |
-| Germany | No |
-| Switzerland | No |
+| Germany | Yes |
+| Switzerland | Yes |
 | United Arab Emirates | No |
 | South Africa | No |
 | Korea | No |
@@ -49,4 +46,4 @@ Cards has the same [system requirements as Power Apps](../limits-and-config.md)
 
 ## Supported platforms for sending cards
 
-Cards can be sent to [Microsoft Teams](/send-a-card/send-card-in-teams.md) in desktop, mobile, or web clients.
+Cards can be sent to [Microsoft Teams](send-a-card/send-card-in-teams.md) in desktop, mobile, or web clients.

powerapps-docs/cards/card-requirements.md

@@ -0,0 +1,35 @@
+---
+title: Button set control in cards for Power Apps
+description: Learn about the properties of the button set control in cards for Power Apps.
+author: anuitz
+ms.topic: reference
+ms.custom: 
+ms.reviewer: mkaur
+ms.date: 03/01/2023
+ms.author: anuitz
+search.audienceType:
+  - maker
+contributors:
+  - mduelae
+  - anuitz
+---
+
+# Button set control in cards
+
+A container for a set of [button](button.md) elements.
+
+The button set control can be used to add buttons in places other than the bottom of the card as well as to group buttons together.
+
+## Properties
+
+**[Initially visible](control-reference.md#i)** – If false, this item will be removed from the visual tree.
+
+**[Spacing](control-reference.md#s)** – Controls the amount of spacing between this control and the preceding control.
+
+**[Divider](control-reference.md#d)** – When true, draw a separating line at the top of the control.
+
+**[Height](control-reference.md#h)** – Specifies the height of the control.
+
+**[Repeat for every](control-reference.md#r)** – The source of data that is used to show multiple instances of this control. Learn how to use [repeat for every](control-reference.md#r).
+
+**[Show when](control-reference.md#s)** – Conditional layout expression.

powerapps-docs/cards/controls/button-set.md

@@ -0,0 +1,45 @@
+---
+title: Button control in cards for Power Apps
+description: Learn about the properties of the button control in cards for Power Apps.
+author: anuitz
+ms.topic: reference
+ms.custom: 
+ms.reviewer: mkaur
+ms.date: 03/01/2023
+ms.author: anuitz
+search.audienceType:
+  - maker
+contributors:
+  - mduelae
+  - anuitz
+---
+
+# Button control in cards
+
+A button control that executes Power Fx, opens a URL, shows a screen, or toggles visibility on select. Learn more about [how to use the button control](../make-a-card/ui-elements/use-buttons.md).
+
+Buttons are added under the **actions** section of the tree view at the bottom of the card by default. This button can be placed elsewhere in the card and grouped with other buttons using a [button set control](button-set.md).
+
+## Properties
+
+**[Type](control-reference.md#t)** – What action the button should take on select - can be Show Screen, Run Power Fx, Open Url, or Toggle Visibility.
+
+**[OnSelect](control-reference.md#o)** - The Power Fx that executes when a user taps or clicks on the button of type 'Run Power Fx'.
+
+**[Screen](control-reference.md#s)** - The screen that is shown below the current card when a user taps or clicks on a button of type 'Show Screen'.
+
+**[Url](control-reference.md#u)** - The url to open when a user taps or clicks on a button of type 'Open Url'.
+
+**[Target Elements](control-reference.md#t)** - The elements to change the visibility of when a user taps or clicks on a button of type 'Toggle Visibility'.
+
+**[Title](control-reference.md#t)** - Label for button or link that represents this button.
+
+**[Style](control-reference.md#s)** - Controls the style of a button, which influences how the button is displayed, spoken, etc.
+
+**[IconUrl](control-reference.md#i)** - Optional icon to be shown on the button in conjunction with the title. Supports data URI in version 1.2+.
+
+**[Associated inputs](control-reference.md#a)** - Controls which inputs are associated with the action.
+
+**[Repeat for every](control-reference.md#r)** - The source of data that is used to show multiple instances of this control. Learn how to use [repeat for every](control-reference.md#r).
+
+**[Show when](control-reference.md#s)** - Conditional layout expression.

powerapps-docs/cards/controls/button.md

@@ -0,0 +1,45 @@
+---
+title: Check box control in cards for Power Apps
+description: Learn about the properties of the check box control in cards for Power Apps.
+author: anuitz
+ms.topic: reference
+ms.custom: 
+ms.reviewer: mkaur
+ms.date: 03/01/2023
+ms.author: anuitz
+search.audienceType:
+  - maker
+contributors:
+  - mduelae
+  - anuitz
+---
+
+# Check box control in cards
+
+A checkbox that lets users choose between two options by selecting or clearing.
+
+## Properties
+
+**[Label](control-reference.md#l)** – Label for this input.
+
+**[Title](control-reference.md#t)** – Title for the toggle.
+
+**[Wrap](control-reference.md#w)** – If true, allow text to wrap. Otherwise, text is clipped.
+
+**[Default value](control-reference.md#d)** – The initial selected value. If you want the toggle to be initially on, set this to the value of valueOn's value.
+
+**[Initially visible](control-reference.md#i)** – If false, this item will be removed from the visual tree.
+
+**[Spacing](control-reference.md#s)** – Controls the amount of spacing between this control and the preceding control.
+
+**[Divider](control-reference.md#d)** – When true, draw a separating line at the top of the control.
+
+**[Height](control-reference.md#h)** – Specifies the height of the control.
+
+**[Error message](control-reference.md#e)** – Error message to display when entered input is invalid.
+
+**[Required Field](control-reference.md#r)** – Whether or not this input is required.
+
+**[Repeat for every](control-reference.md#r)** – The source of data that is used to show multiple instances of this control. Learn how to use [repeat for every](control-reference.md#r).
+
+**[Show when](control-reference.md#s)** – Conditional layout expression.