From dcd37a66f49ae381e9225acabb4862be2304962e Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 14 Apr 2026 21:23:28 +0000
Subject: [PATCH] Document review changes workflow for custom Helm chart
 add-ons

Generated-By: mintlify-agent
---
 addons/custom-helm-charts.mdx | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/addons/custom-helm-charts.mdx b/addons/custom-helm-charts.mdx
index 6ee897a..437a79b 100644
--- a/addons/custom-helm-charts.mdx
+++ b/addons/custom-helm-charts.mdx
@@ -17,16 +17,13 @@ Deploy Helm charts through the Porter dashboard for a managed experience with vi
     Navigate to **Add-ons** in your Porter dashboard and select **Helm Chart**.
   </Step>
   <Step title="Configure the chart">
-    Enter the Helm repository URL and select the chart you want to deploy.
-  </Step>
-  <Step title="Select version">
-    Choose the chart version you want to install.
+    Enter the Helm repository URL, chart name, and chart version.
   </Step>
   <Step title="Customize values (optional)">
-    Modify any values from the chart's default configuration as needed.
+    Modify any values from the chart's default configuration as needed using the YAML editor.
   </Step>
-  <Step title="Deploy">
-    Click **Deploy** to install the chart to your cluster.
+  <Step title="Review and deploy">
+    Click **Review changes** to open a diff view comparing your current configuration with the new one. From the review dialog, you can either deploy the changes or discard them.
   </Step>
 </Steps>
 
@@ -38,10 +35,18 @@ Since custom Helm charts install external components into your cluster, they fal
 
 Once deployed, you can:
 - View the chart status in the Add-ons tab
-- Update values and redeploy
+- Update values and review a diff of your changes before redeploying
 - Upgrade to newer chart versions
 - Delete the chart when no longer needed
 
+### Reviewing changes before deploy
+
+When you modify a deployed Helm chart's configuration, clicking **Review changes** opens a side-by-side diff that compares the current revision with your pending updates. This includes changes to chart settings (repository URL, chart name, version) and custom values YAML.
+
+From the review dialog you can:
+- **Deploy changes** — apply the new configuration to your cluster
+- **Discard changes** — revert the form to the last deployed state
+
 ---
 
 ## Deploying via Helm CLI