[App Service] Improve az webapp deploy parameter documentation (#29759, #29758, #29561, #30110)

- Add default timeout value to --timeout help text
- Clarify --acr-use-identity default behavior
- Document --track-status behavior and parameter relationships
- Add more examples to az webapp deploy help (URL deploy, slots, --clean)

Fixes #29759
Fixes #29758
Fixes #29561
Fixes #30110

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: seligj95

src/azure-cli/azure/cli/command_modules/appservice/_help.py

@@ -3287,9 +3287,24 @@
 helps['webapp deploy'] = """
     type: command
     short-summary: Deploys a provided artifact to Azure Web Apps.
+    long-summary: |
+        Supports deploying from local files (--src-path) or remote URLs (--src-url).
+        When --track-status is enabled (the default for Linux web apps), the command monitors
+        application startup after deployment by polling health endpoints. If the app fails to
+        start within the expected window, the command returns a non-zero exit code. Use
+        --async false together with --track-status true to wait for full deployment completion
+        before tracking begins.
     examples:
-    - name: Deploy a war file asynchronously.
-      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path SourcePath --type war --async true
-    - name: Deploy a static text file to wwwroot/staticfiles/test.txt
-      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path SourcePath --type static --target-path staticfiles/test.txt
+    - name: Deploy a war file asynchronously from local path.
+      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path app.war --type war --async true
+    - name: Deploy a zip file from a remote URL.
+      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-url https://example.com/app.zip
+    - name: Deploy without cleaning the target directory.
+      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path app.zip --clean false
+    - name: Deploy with runtime status tracking for Linux web app.
+      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path app.zip --track-status true --async false
+    - name: Deploy to a specific slot.
+      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path app.jar --type jar --slot staging
+    - name: Deploy a static text file to a custom path.
+      text: az webapp deploy --resource-group ResourceGroup --name AppName --src-path file.txt --type static --target-path staticfiles/file.txt
 """

src/azure-cli/azure/cli/command_modules/appservice/_params.py

@@ -591,7 +591,7 @@ def load_arguments(self, _):
                 c.ignore('reserved_instance_count')
                 c.argument('runtime', help="Canonicalized web runtime in the format of Framework:Version, e.g. \"PHP:7.2\"."
                                            "Use `az webapp list-runtimes` for available list")
-                c.argument('acr_use_identity', arg_type=get_three_state_flag(return_label=True), help="Enable or disable pull image from acr use managed identity")
+                c.argument('acr_use_identity', arg_type=get_three_state_flag(return_label=True), help="If not specified, managed identity will not be used for ACR image pull.")
                 c.argument('acr_identity', help="Accept system or user assigned identity which will be set for acr image pull. "
                                                 "Use \'[system]\' to refer system assigned identity, or a resource id to refer user assigned identity.")
             c.argument('java_version',
@@ -1007,9 +1007,9 @@ def load_arguments(self, _):
         c.argument('clean', help='If true, cleans the target directory prior to deploying the file(s). Default value is determined based on artifact type.', arg_type=get_three_state_flag())
         c.argument('ignore_stack', help='If true, any stack-specific defaults are ignored.', arg_type=get_three_state_flag())
         c.argument('reset', help='Reset Java apps to the default parking page if set to true with no type specified.', arg_type=get_three_state_flag())
-        c.argument('timeout', type=int, help='Timeout for the deployment operation in milliseconds. Ignored when using "--src-url" since synchronous deployments are not yet supported when using "--src-url"')
-        c.argument('slot', help="The name of the slot. Default to the productions slot if not specified.")
-        c.argument('track_status', help="If true, web app startup status during deployment will be tracked for linux web apps.",
+        c.argument('timeout', type=int, help='Timeout for the deployment operation in milliseconds. Default: 900000 (15 minutes). Ignored when using "--src-url".')
+        c.argument('slot', help="The name of the slot. Default to the production slot if not specified.")
+        c.argument('track_status', help="If not specified, the command will track app startup and runtime health. Default: true.",
                    arg_type=get_three_state_flag())
         c.argument('enable_kudu_warmup', help="If true, kudu will be warmed up before performing deployment for a linux webapp.",
                    arg_type=get_three_state_flag())