Updated based on feedback from Cephas

Author: tulikac

articles/app-service/configure-sidecar.md

@@ -25,12 +25,27 @@ For a custom container, you need to explicitly enable sidecar support. In the po
 
 :::image type="content" source="media/configure-sidecar/enable-sidecar.png" alt-text="A screenshot showing a custom container app's container settings with the Start Update button highlighted.":::
 
-With the Azure CLI, set `LinuxFxVersion` to `sitecontainers`. For example:
+With the Azure CLI, convert your web app to use the `sitecontainers` configuration. For example:
 
 ```azurecli
-az webapp config set --name <app-name> --resource-group <resource-group> --linux-fx-version sitecontainers
+az webapp sitecontainers convert --mode sitecontainers --name <YourWebAppName> --resource-group <YourResourceGroup>
 ```
 
+This updates the `LinuxFxVersion` to `sitecontainers` and enables support for the sidecar pattern.
+
+### Revert to classic custom container (Docker) mode
+
+If you need to switch back from the sidecar-enabled configuration to the classic Docker-based setup, run the following command:
+
+```azurecli
+az webapp sitecontainers convert \
+  --mode docker \
+  --name <app-name> \
+  --resource-group <resource-group>
+```
+
+This command removes all sidecar containers and resets your app to use the classic `DOCKER|<image>` style configuration. For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](https://learn.microsoft.com/cli/azure/webapp/sitecontainers?view=azure-cli-latest).
+
 For more information, see [What are the differences for sidecar-enabled custom containers?](#what-are-the-differences-for-sidecar-enabled-custom-containers)
 
 ### What are the differences for sidecar-enabled custom containers?

articles/app-service/overview-sidecar.md

@@ -52,35 +52,6 @@ Use Azure Monitor, Log Analytics, and the Diagnose & Solve blade in the Azure po
 ### Are there any limitations?
 Persistent Azure storage is not supported for sidecars. App Service Environment (ASE) and national clouds may not be supported yet. Check the latest Azure documentation for updates.
 
-### How do I revert my app from the new sidecar configuration back to the classic custom container setup?
-
-If you’ve already moved your web app to the new sidecar configuration (`sitecontainers`) and want to revert to the classic custom container (`docker`) setup, you can do so using the Azure CLI.
-
-Use the following command:
-
-```bash
-az webapp sitecontainers convert --mode docker --name <YourWebAppName> --resource-group <YourResourceGroup>
-```
-
-This will delete all sidecar configurations and switch your app back to using the `DOCKER|`-style `linuxFxVersion`. You’ll see output confirming the conversion:
-
-```json
-{
-  "mode": "docker",
-  "result": "success"
-}
-```
-
-> **Note:** You must run this command on a web app that is currently using the `sitecontainers` configuration. If your app is not in that mode, the CLI will return an error.
-
-To switch *to* sidecar mode from a classic custom container setup, use:
-
-```bash
-az webapp sitecontainers convert --mode sitecontainers --name <YourWebAppName> --resource-group <YourResourceGroup>
-```
-
-For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](https://learn.microsoft.com/en-us/cli/azure/webapp/sitecontainers?view=azure-cli-latest).
-
 ## More resources
 
 - [Interactive guide: sidecars in Azure App Service](https://mslabs.cloudguides.com/guides/Modernize%20existing%20web%20apps%20with%20new%20capabilities%20using%20Sidecar%20patterns)