From 5fb7ff499c175fef043f5a16828d3e3e93085bc2 Mon Sep 17 00:00:00 2001
From: Jonathan Summers-Muir <MildTomato@users.noreply.github.com>
Date: Mon, 12 Feb 2024 15:52:19 +0000
Subject: [PATCH] chore/update-warnings-for-branching (#19464)

* Update branching.mdx

* Update branching.mdx

* Update branching.mdx
---
 apps/docs/pages/guides/platform/branching.mdx | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/apps/docs/pages/guides/platform/branching.mdx b/apps/docs/pages/guides/platform/branching.mdx
index 172e1f7321f..7421a6f9b14 100644
--- a/apps/docs/pages/guides/platform/branching.mdx
+++ b/apps/docs/pages/guides/platform/branching.mdx
@@ -7,11 +7,24 @@ export const meta = {
   subtitle: 'Use Supabase Branches to test and preview changes',
 }
 
-Use branching to safely and easily experiment with changes to your Supabase projects.
+<Admonition type="caution" label="Do not use Branching in production">
 
-<Admonition type="caution" label="Branching only available for Private Early Access.">
+Branching is an early access only feature, which must not be used in a production setting.
 
-We do not recommended Branching in a production environment while it is in Early Access.
+</Admonition>
+
+Use branching to safely and easily experiment with changes to your Supabase project.
+
+Supabase branches work like Git branches. They let you create and test changes like new configurations, database schemas, or features in a separate, temporary instance without affecting your production setup.
+
+When you're ready to ship your changes, merge your branch to update your production instance with the new changes.
+
+If you understand Git, you already understand Supabase Branching.
+
+<Admonition
+  type="note"
+  label="Branching is Early Access only, and only available on the Pro Plan and above."
+>
 
 Branching will move to Public Beta in future, but only available for Pro plan and above.