@pnp/cli-microsoft365 8.1.0-beta.bf59841 → 9.0.0-beta.2b15817

package/docs/docs/cmd/flow/flow-get.mdx

@@ -62,352 +62,218 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
 
   ```json
   {
-    "name": "ca76d7b8-3b76-4050-8c03-9fb310ad172f",
-    "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f",
+    "name": "a18e89d1-4c75-41e4-9517-e90aedc079be",
+    "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/a18e89d1-4c75-41e4-9517-e90aedc079be",
     "type": "Microsoft.ProcessSimple/environments/flows",
     "properties": {
       "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
-      "displayName": "My Flow",
+      "displayName": "TEST",
       "userType": "Owner",
       "definition": {
         "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
         "contentVersion": "1.0.0.0",
         "parameters": {
-          "$connections": {
-            "defaultValue": {},
-            "type": "Object"
-          },
           "$authentication": {
             "defaultValue": {},
             "type": "SecureObject"
+          },
+          "$connections": {
+            "defaultValue": {},
+            "type": "Object"
           }
         },
         "triggers": {
-          "When_a_file_is_created_in_a_folder": {
-            "recurrence": {
-              "frequency": "Minute",
-              "interval": 1
-            },
+          "manual": {
             "metadata": {
-              "%252fComputer%2bVision%2bDemo": "/My Flow Demo",
-              "operationMetadataId": "2e0aa276-5536-4f67-a7b7-c1a37a91b8ca",
-              "%252fShared%2bDocuments": "/Shared Documents"
+              "operationMetadataId": "04077d6a-9fdd-4c79-b742-09a8d5c022eb"
             },
-            "type": "OpenApiConnection",
+            "type": "Request",
+            "kind": "Button",
             "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-                "connectionName": "shared_sharepointonline",
-                "operationId": "OnNewFile"
-              },
-              "parameters": {
-                "dataset": "https://contoso.sharepoint.com/sites/contosoHome",
-                "folderId": "%252fShared%2bDocuments",
-                "inferContentType": true
-              },
-              "authentication": "@parameters('$authentication')"
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "description": "Please enter your input",
+                    "title": "Text",
+                    "type": "string",
+                    "x-ms-content-hint": "TEXT",
+                    "x-ms-dynamically-added": true
+                  },
+                  "boolean": {
+                    "description": "Please select yes or no",
+                    "title": "Boolean",
+                    "type": "boolean",
+                    "x-ms-content-hint": "BOOLEAN",
+                    "x-ms-dynamically-added": true
+                  },
+                  "number": {
+                    "description": "Please enter a number",
+                    "title": "Number",
+                    "type": "number",
+                    "x-ms-content-hint": "NUMBER",
+                    "x-ms-dynamically-added": true
+                  }
+                },
+                "required": [
+                  "text",
+                  "boolean",
+                  "number"
+                ]
+              }
             }
           }
         },
         "actions": {
-          "Analyze_Image": {
-            "runAfter": {
-              "Initialize_variable": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "82b95160-9c96-4507-ad8c-c688ea95c2b1"
-            },
-            "type": "OpenApiConnection",
-            "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_cognitiveservicescomputervision",
-                "connectionName": "shared_cognitiveservicescomputervision",
-                "operationId": "AnalyzeImageV2"
-              },
-              "parameters": {
-                "format": "Image Content",
-                "Image": "@triggerOutputs()?['body']"
-              },
-              "authentication": "@parameters('$authentication')"
-            }
-          },
-          "Compose": {
-            "runAfter": {
-              "Analyze_Image": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "cbd09106-eb7a-4743-b553-8b11cd09a90c"
-            },
-            "type": "Compose",
-            "inputs": "@outputs('Analyze_Image')?['body/tags']"
-          },
           "Initialize_variable": {
             "runAfter": {},
-            "metadata": {
-              "operationMetadataId": "818f9da8-8ebf-4081-8d7b-8fe37470cd57"
-            },
             "type": "InitializeVariable",
             "inputs": {
               "variables": [
                 {
-                  "name": "FilePath",
-                  "type": "string",
-                  "value": "@{decodeUriComponent(decodeUriComponent(triggerOutputs()?['headers/x-ms-file-id']))}"
+                  "name": "TEST",
+                  "type": "string"
                 }
               ]
             }
+          }
+        }
+      },
+      "triggerSchema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "description": "Please enter your input",
+            "title": "Text",
+            "type": "string",
+            "x-ms-content-hint": "TEXT",
+            "x-ms-dynamically-added": true
           },
-          "Send_an_HTTP_request_to_SharePoint": {
-            "runAfter": {
-              "Compose": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "0e9b2bf7-c52e-4b28-8351-2850a3373186"
-            },
-            "type": "OpenApiConnection",
-            "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-                "connectionName": "shared_sharepointonline",
-                "operationId": "HttpRequest"
-              },
-              "parameters": {
-                "dataset": "https://contoso.sharepoint.com/sites/contosoHome",
-                "parameters/method": "GET",
-                "parameters/uri": "_api/web/getFileByServerRelativeURL('@{concat('/sites/contosoHome/', variables('FilePath'))}')?$select=ListItemAllFields/ID&$expand=ListItemAllFields"
-              },
-              "authentication": "@parameters('$authentication')"
-            }
-          },
-          "Parse_JSON": {
-            "runAfter": {
-              "Send_an_HTTP_request_to_SharePoint": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "7d758c3f-f603-44d0-94b6-26cb08590fb3"
-            },
-            "type": "ParseJson",
-            "inputs": {
-              "content": "@body('Send_an_HTTP_request_to_SharePoint')",
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "d": {
-                    "type": "object",
-                    "properties": {
-                      "__metadata": {
-                        "type": "object",
-                        "properties": {
-                          "id": {
-                            "type": "string"
-                          },
-                          "uri": {
-                            "type": "string"
-                          },
-                          "type": {
-                            "type": "string"
-                          }
-                        }
-                      },
-                      "ListItemAllFields": {
-                        "type": "object",
-                        "properties": {
-                          "__metadata": {
-                            "type": "object",
-                            "properties": {
-                              "id": {
-                                "type": "string"
-                              },
-                              "uri": {
-                                "type": "string"
-                              },
-                              "etag": {
-                                "type": "string"
-                              },
-                              "type": {
-                                "type": "string"
-                              }
-                            }
-                          },
-                          "Id": {
-                            "type": "integer"
-                          },
-                          "ID": {
-                            "type": "integer"
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
+          "boolean": {
+            "description": "Please select yes or no",
+            "title": "Boolean",
+            "type": "boolean",
+            "x-ms-content-hint": "BOOLEAN",
+            "x-ms-dynamically-added": true
           },
-          "Update_file_properties": {
-            "runAfter": {
-              "Parse_JSON": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "c1a801a8-1f96-498a-a356-82c9d0dd8188"
-            },
-            "type": "OpenApiConnection",
-            "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-                "connectionName": "shared_sharepointonline",
-                "operationId": "PatchFileItem"
-              },
-              "parameters": {
-                "dataset": "https://contoso.sharepoint.com/sites/contosoHome",
-                "table": "13e0b5a3-f626-4272-a73b-a3e84978199b",
-                "id": "@body('Parse_JSON')?['d']?['ListItemAllFields']?['Id']",
-                "item/CognitiveTags": "@join(outputs('Analyze_Image')?['body/description/tags'], ', ')"
-              },
-              "authentication": "@parameters('$authentication')"
-            }
+          "number": {
+            "description": "Please enter a number",
+            "title": "Number",
+            "type": "number",
+            "x-ms-content-hint": "NUMBER",
+            "x-ms-dynamically-added": true
           }
         },
-        "outputs": {}
+        "required": [
+          "text",
+          "boolean",
+          "number"
+        ]
       },
       "state": "Started",
-      "connectionReferences": {
-        "shared_cognitiveservicescomputervision": {
-          "connectionName": "shared-cognitiveserv-34d89cec-971e-41b6-8c79-247c97eecec5",
-          "source": "Embedded",
-          "id": "/providers/Microsoft.PowerApps/apis/shared_cognitiveservicescomputervision",
-          "displayName": "My Flow API",
-          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1549/1.0.1549.2680/cognitiveservicescomputervision/icon.png",
-          "brandColor": "#1267AE",
-          "tier": "Standard"
-        },
-        "shared_sharepointonline": {
-          "connectionName": "shared-sharepointonl-1c433d0f-a030-45eb-9795-8c2585f84781",
-          "source": "Embedded",
-          "id": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-          "displayName": "SharePoint",
-          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1610-greyhound-localization-RelayFix/1.0.1610.3091/sharepointonline/icon.png",
-          "brandColor": "#036C70",
+      "plan": "NotSpecified",
+      "connectionReferences": {},
+      "installedConnectionReferences": {
+        "shared_approvals": {
+          "connectionName": "shared-approvals-068230cf-43ef-455d-b823-ee6f989d0193",
+          "apiDefinition": {
+            "name": "shared_approvals",
+            "id": "/providers/Microsoft.PowerApps/apis/shared_approvals",
+            "type": "/providers/Microsoft.PowerApps/apis",
+            "properties": {
+              "displayName": "Approvals",
+              "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1682/1.0.1682.3671/approvals/icon.png",
+              "purpose": "NotSpecified",
+              "connectionParameters": {},
+              "runtimeUrls": [
+                "https://europe-002.azure-apim.net/apim/approvals"
+              ],
+              "primaryRuntimeUrl": "https://europe-002.azure-apim.net/apim/approvals",
+              "metadata": {
+                "source": "marketplace",
+                "brandColor": "#6464F5",
+                "connectionLimits": {
+                  "*": 1
+                },
+                "useNewApimVersion": "true",
+                "version": {
+                  "previous": "releases/v1.0.1679\\1.0.1679.3643",
+                  "current": "releases/v1.0.1682\\1.0.1682.3671"
+                }
+              },
+              "capabilities": [
+                "actions"
+              ],
+              "tier": "Standard",
+              "isCustomApi": false,
+              "description": "Enables approvals in workflows.",
+              "createdTime": "2018-09-16T08:09:23.9434372Z",
+              "changedTime": "2024-03-11T18:25:46.7755101Z",
+              "publisher": "Microsoft"
+            }
+          },
+          "source": "Invoker",
+          "id": "/providers/Microsoft.PowerApps/apis/shared_approvals",
+          "displayName": "Approvals",
+          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1682/1.0.1682.3671/approvals/icon.png",
+          "brandColor": "#6464F5",
           "tier": "Standard"
         }
       },
-      "createdTime": "2022-06-20T15:13:24.5135728Z",
-      "lastModifiedTime": "2022-11-01T14:15:31.5790933Z",
+      "createdTime": "2023-07-25T18:42:15.7693633Z",
+      "lastModifiedTime": "2024-03-08T10:24:12.0147046Z",
       "flowSuspensionReason": "None",
       "environment": {
-        "name": "Default-00000000-0000-0000-0000-000000000000",
+        "name": "Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
         "type": "Microsoft.ProcessSimple/environments",
-        "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000"
+        "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d"
       },
       "definitionSummary": {
         "triggers": [
           {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "OnNewFile",
+            "type": "Request",
+            "kind": "Button",
             "metadata": {
-              "%252fComputer%2bVision%2bDemo": "/My Flow Demo",
-              "operationMetadataId": "2e0aa276-5536-4f67-a7b7-c1a37a91b8ca",
-              "%252fShared%2bDocuments": "/Shared Documents"
+              "operationMetadataId": "04077d6a-9fdd-4c79-b742-09a8d5c022eb"
             }
           }
         ],
         "actions": [
           {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "AnalyzeImageV2",
-            "metadata": {
-              "operationMetadataId": "82b95160-9c96-4507-ad8c-c688ea95c2b1"
-            }
-          },
-          {
-            "type": "Compose",
-            "metadata": {
-              "operationMetadataId": "cbd09106-eb7a-4743-b553-8b11cd09a90c"
-            }
-          },
-          {
-            "type": "InitializeVariable",
-            "metadata": {
-              "operationMetadataId": "818f9da8-8ebf-4081-8d7b-8fe37470cd57"
-            }
-          },
-          {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "HttpRequest",
-            "metadata": {
-              "operationMetadataId": "0e9b2bf7-c52e-4b28-8351-2850a3373186"
-            }
-          },
-          {
-            "type": "ParseJson",
-            "metadata": {
-              "operationMetadataId": "7d758c3f-f603-44d0-94b6-26cb08590fb3"
-            }
-          },
-          {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "PatchFileItem",
-            "metadata": {
-              "operationMetadataId": "c1a801a8-1f96-498a-a356-82c9d0dd8188"
-            }
+            "type": "InitializeVariable"
           }
         ]
       },
       "creator": {
-        "tenantId": "00000000-0000-0000-0000-000000000000",
-        "objectId": "e1251b10-1ba4-49e3-b35a-933e3f21772b",
-        "userId": "e1251b10-1ba4-49e3-b35a-933e3f21772b",
+        "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+        "objectId": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+        "userId": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
         "userType": "ActiveDirectory"
       },
-      "installationStatus": "NotApplicable",
+      "flowTriggerUri": "https://europe-002.azure-apim.net:443/apim/logicflows/A18E89D14C7541E49517E90AEDC079BE-5FA12B1209B98E3B/triggers/manual/run?api-version=2016-06-01",
+      "installationStatus": "Installed",
       "provisioningMethod": "FromDefinition",
       "flowFailureAlertSubscribed": true,
-      "referencedResources": [
-        {
-          "service": "sharepoint",
-          "resource": {
-            "site": "https://contoso.sharepoint.com/sites/contosoHome"
-          },
-          "referencers": [
-            {
-              "referenceSourceType": "Triggers",
-              "operationId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline/apiOperations/OnNewFile"
-            },
-            {
-              "referenceSourceType": "Actions",
-              "operationId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline/apiOperations/HttpRequest"
-            }
-          ]
+      "referencedResources": [],
+      "licenseData": {
+        "performanceProfile": {
+          "throttles": {
+            "mode": "High"
+          }
         },
-        {
-          "service": "sharepoint",
-          "resource": {
-            "site": "https://contoso.sharepoint.com/sites/contosoHome",
-            "list": "13e0b5a3-f626-4272-a73b-a3e84978199b"
-          },
-          "referencers": [
-            {
-              "referenceSourceType": "Actions",
-              "operationId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline/apiOperations/PatchFileItem"
-            }
-          ]
-        }
-      ],
-      "isManaged": false
+        "flowLicenseName": "placeholder"
+      },
+      "isManaged": false,
+      "machineDescriptionData": {},
+      "flowOpenAiData": {
+        "isConsequential": false,
+        "isConsequentialFlagOverwritten": false
+      }
     },
-    "displayName": "My Flow",
+    "displayName": "TEST",
     "description": "",
-    "triggers": "OpenApiConnection",
-    "actions": "OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem"
+    "triggers": "Request-Button",
+    "actions": "InitializeVariable"
   }
   ```
 

package/docs/docs/cmd/outlook/message/message-get.mdx

@@ -19,10 +19,10 @@ m365 outlook message get [options]
 : ID of the message.
 
 `--userId [userId]`
-: ID of the user from which to retrieve the message. Specify either `userId` or `userPrincipalName`, but not both. This option is required when using application permissions.
+: ID of the user from which to retrieve the message. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
 
-`--userPrincipalName [userPrincipalName]`
-: UPN of the user from which to retrieve the message Specify either `userId` or `userPrincipalName`, but not both. This option is required when using application permissions.
+`--userName [userName]`
+: UPN of the user from which to retrieve the message Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
 ```
 
 <Global />
@@ -38,7 +38,7 @@ m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYm
 Get a specific message using delegated permissions from a shared mailbox.
 
 ```sh
-m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName sharedmailbox@tenant.com
+m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userName sharedmailbox@tenant.com
 ```
 
 Get a specific message from a specific user retrieved by user ID using application permissions.
@@ -50,7 +50,7 @@ m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYm
 Get a specific message from a specific user retrieved by user principal name using application permissions.
 
 ```sh
-m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName user@tenant.com
+m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userName user@tenant.com
 ```
 
 ## Response

package/docs/docs/cmd/pa/app/app-export.mdx

@@ -14,25 +14,25 @@ m365 pa app export [options]
 
 ```md definition-list
 `-n, --name <name>`
-: The name (GUID) of the Power Apps app to export
+: The name (GUID) of the Power Apps app to export.
 
 `-e, --environmentName <environmentName>`
-: The name of the environment for which to export the app
+: The name of the environment for which to export the app.
 
 `--packageDisplayName [packageDisplayName]`
-: The display name to use in the exported package
+: The display name to use in the exported package.
 
 `-d, --packageDescription [packageDescription]`
-: The description to use in the exported package
+: The description to use in the exported package.
 
 `-c, --packageCreatedBy [packageCreatedBy]`
-: The name of the person to be used as the creator of the exported package
+: The name of the person to be used as the creator of the exported package.
 
 `-s, --packageSourceEnvironment [packageSourceEnvironment]`
-: The name of the source environment from which the exported package was taken
+: The name of the source environment from which the exported package was taken.
 
 `-p, --path [path]`
-: The path to save the exported package to. If not specified the app will be exported in the current working directory
+: The path to save the exported package to. If not specified the app will be exported in the current working directory.
 ```
 
 <Global />
@@ -42,13 +42,19 @@ m365 pa app export [options]
 Export the specified Power App as a ZIP file
 
 ```sh
-m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp"
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+```
+
+Export the specified Power App as a ZIP file with a custom package name
+
+```sh
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "Assets app"
 ```
 
 Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
 
 ```sh
-m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "Assets app" --packageDescription "App to track assets of people" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
 ```
 
 ## Response

package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx

@@ -14,28 +14,25 @@ m365 spfx project github workflow add [options]
 
 ```md definition-list
 `-n, --name [name]`
-: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'
+: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'.
 
 `-b, --branchName [branchName]`
-: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
+: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'.
 
 `-m, --manuallyTrigger`
-: When specified a manual trigger option will be added to the workflow: `workflow_dispatch`
+: When specified a manual trigger option will be added to the workflow: `workflow_dispatch`.
 
 `-l, --loginMethod [loginMethod]`
-: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`'
+: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`.
 
 `-s, --scope [scope]`
-: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
+: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`.
 
 `-u, --siteUrl [siteUrl]`
-: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
+: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`.
 
 `--skipFeatureDeployment`
-: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant
-
-`--overwrite`
-: When specified the workflow will overwrite the existing .sppkg if it is already deployed in the app catalog.
+: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant.
 ```
 
 <Global />
@@ -59,6 +56,8 @@ For the `user` login method you will need to create the following secrets in Git
 
 This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
 
+The workflow will overwrite the existing .sppkg if it is already deployed in the app catalog. Overwriting your sppkg file on every deployment is required to make continuous delivery of the latest version of your app which is the aim of the continuous delivery pipeline.
+
 :::info
 
 Run this command in the SPFx solution folder.
@@ -67,7 +66,7 @@ Run this command in the SPFx solution folder.
     
 ## Examples
 
-Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main
+Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main.
 
 ```sh
 m365 spfx project github workflow add 
@@ -79,7 +78,7 @@ Adds a GitHub workflow for a SharePoint Framework project with `user` login meth
 m365 spfx project github workflow add --manuallyTrigger --loginMethod "user"
 ```
 
-Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog
+Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog.
 
 ```sh
 m365 spfx project github workflow add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"