diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md
index 243b24960..d34332308 100644
--- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md
+++ b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md
@@ -3,7 +3,7 @@ type: docs
 title: "How-To: Deploy an application with Github Actions"
 linkTitle: "Deploy via GitHub Actions"
 description: "Learn about adding your Radius apps to your deployment pipelines with GitHub Actions" 
-weight: 200
+weight: 300
 categories: "How-To"
 tags: ["CI/CD"]
 ---
diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md
index 5153cb142..918b6f83b 100644
--- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md
+++ b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md
@@ -1,35 +1,31 @@
 ---
 type: docs
-title: "Overview: Deploying applications into a Radius environment"
+title: "How-To: Deploying applications into a Radius environment"
 linkTitle: "Deploy via CLI"
 description: "Learn how to deploy a Radius application"
-weight: 100
-categories: "Overview"
+weight: 200
+categories: "How-To"
 tags: ["deployments"]
 ---
 
-## Run an application
+## Pre-requisites 
+- [An authored Radius application]({{< ref author-apps >}})
 
-Once you have [authored an application]({{< ref author-apps >}}), you can run an application using the [`rad run`]({{< ref rad_run >}}) command.
+## Step 1 : Deploy an application into a Radius environment
 
-```bash
- rad run app.bicep
- ```
-
-This will deploy the application to your environment, create port-forwards for all container ports, and stream container logs to the console.
-
-## Deploy an application
+{{< tabs Deploy-app Deploy-app-with-parameters >}}
 
+{{% codetab %}}
 An application can be deployed to an environment with [`rad deploy`]({{< ref rad_deploy>}}):
 
 ```bash
  rad deploy app.bicep
  ```
  This will deploy the application to the created Radius environment.
+ {{% /codetab %}}
 
-### Parameters
-
-Parameters can be included as part of `rad run` or `rad deploy` via the `-p/--parameters` flag:
+ {{% codetab %}}
+Parameters can be included as part of `rad deploy` via the `-p/--parameters` flag:
 
 ```bash
  rad deploy app.bicep -p param1=value1 -p param2=value2
@@ -38,4 +34,9 @@ Parameters can be included as part of `rad run` or `rad deploy` via the `-p/--pa
  This will deploy the application to the created Radius environment injecting the parameters into the application.
 
  You can find more examples of deploying applications with parameters [here]({{< ref "rad_deploy#examples" >}}).
- 
+ {{% /codetab %}}
+
+ {{< /tabs >}}
+
+ > Follow the [how-to guide]({{< ref troubleshooting-radius >}}) for guidance on troubleshooting your Radius application
+
diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md
new file mode 100644
index 000000000..288c937e8
--- /dev/null
+++ b/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md
@@ -0,0 +1,42 @@
+---
+type: docs
+title: "How-To: Run applications on Radius"
+linkTitle: "Run apps"
+description: "Learn how to run applications on Radius"
+weight: 100
+categories: "How-To"
+tags: ["deployments"]
+---
+
+## Pre-requisites 
+- [An authored Radius application]({{< ref author-apps >}})
+
+## Step 1: Run an application
+
+{{< tabs Run-app Run-app-with-parameters >}}
+
+{{% codetab %}}
+You can run an application using the [`rad run`]({{< ref rad_run >}}) command.
+
+```bash
+ rad run app.bicep
+ ```
+
+This will deploy the application to your environment, create port-forwards for all container ports, and stream container logs to the console.
+{{% /codetab %}}
+
+{{% codetab %}}
+Parameters can be included as part of `rad run` via the `-p/--parameters` flag:
+
+```bash
+ rad run app.bicep -p param1=value1 -p param2=value2
+```
+
+This will deploy the application to the created Radius environment injecting the parameters into the application.
+
+You can find more examples of deploying applications with parameters [here]({{< ref "rad_run#examples" >}}).
+{{% /codetab %}}
+
+ {{< /tabs >}}
+
+ > Follow the [how-to guide]({{< ref troubleshooting-radius >}}) for guidance on troubleshooting your apps