docs: improve Azure cli config upload (#1433)

improve Azure cli config upload to separate steps into 2 sections, for plain files and tarballs

Author: JTorreG

content/nginxaas-azure/getting-started/nginx-configuration/nginx-configuration-azure-cli.md

@@ -23,29 +23,66 @@ F5 NGINXaaS for Azure (NGINXaaS) configurations can be managed using the Azure C
 
 To create a new NGINX configuration, use the `az nginx deployment configuration create` command:
 
+There are two supported ways to upload your configuration:
+
+1. **Plain file upload** — Upload one or more configuration files directly using the `--files` parameter.
+1. **Tarball upload** — Package your configuration files into a `.tar.gz` archive and upload it using the `--package` parameter.
+
+Both methods are valid and can be used depending on how your configuration is structured.
+
 ```shell
 az nginx deployment configuration create --configuration-name
-                                         --deployment-name
-                                         --resource-group
-                                         [--files]
-                                         [--location]
-                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
-                                         [--package]
-                                         [--protected-files]
-                                         [--root-file]
+                                      --deployment-name
+                                      --resource-group
+                                      [--files]
+                                      [--location]
+                                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
+                                      [--package]
+                                      [--protected-files]
+                                      [--root-file]
 ```
 
 ### Validate your configuration
 
 You can use the `analyze` command to validate your configuration before submitting it to the deployment:
 
+<div data-testid="validation_tabs">
+{{<tabs name="validate_configuration_examples" >}}
+
+{{%tab name="Validate plain files"%}}
+
+If you are uploading individual configuration files, you can pass them as base64-encoded content through the `--files` parameter:
+
 ```shell
 az nginx deployment configuration analyze --deployment-name $DEPLOYMENT_NAME \
    --resource-group $RESOURCE_GROUP --root-file /etc/nginx/nginx.conf \
    --name default --files "$FILES_CONTENT"
-````
+```
 
-### Examples
+{{%/tab%}}
+
+{{%tab name="Validate a tarball package"%}}
+
+If you are using a `.tar.gz` archive, encode it and pass it through the `--package` parameter:
+
+```shell
+TAR_DATA=$(base64 -i nginx.tar.gz)
+az nginx deployment configuration analyze --deployment-name myDeployment \
+   --resource-group myResourceGroup --root-file nginx.conf \
+   --name default --package data="$TAR_DATA"
+```
+
+{{%/tab%}}
+{{< /tabs >}}
+</div>
+
+### Upload a configuration
+
+{{<tabs name="upload_configuration_examples" >}}
+
+{{%tab name="Upload plain files"%}}
+
+The following examples show how to upload plain configuration files directly to your deployment:
 
 - Create a single file configuration:
 
@@ -90,7 +127,13 @@ az nginx deployment configuration analyze --deployment-name $DEPLOYMENT_NAME \
       'virtual-path':'/etc/nginx/conf.d/proxy.conf'}]"
    ```
 
-- Upload package with config files:
+{{%/tab%}}
+
+{{%tab name="Upload a tarball package"%}}
+
+You can bundle your configuration files into a `.tar.gz` archive and upload it as a single package.
+
+Upload package with config files:
 
    ```shell
    $ tar -czf nginx.tar.gz nginx
@@ -172,9 +215,10 @@ az nginx deployment configuration analyze --deployment-name $DEPLOYMENT_NAME \
       'virtual-path':'/etc/nginx/conf.d/proxyprot.conf'}]"
    ```
 
-See the [Azure CLI Configuration Create Documentation](https://learn.microsoft.com/en-us/cli/azure/nginx/deployment/configuration?view=azure-cli-latest#az-nginx-deployment-configuration-create) for more details on the available parameters.
-
+{{%/tab%}}
+{{< /tabs >}}
 
+See the [Azure CLI Configuration Create Documentation](https://learn.microsoft.com/en-us/cli/azure/nginx/deployment/configuration?view=azure-cli-latest#az-nginx-deployment-configuration-create) for more details on the available parameters.
 
 ## Update a configuration