diff --git a/docs/concepts/debug.md b/docs/concepts/debug.md
index 193e6f2ca..94ae5d09d 100644
--- a/docs/concepts/debug.md
+++ b/docs/concepts/debug.md
@@ -10,4 +10,16 @@ Defang includes an AI-driven tool to help you debug your cloud applications. The
 
 :::warning
 The AI debugging assistant is currently in preview and is currently limited in its capabilities. We plan to expand the capabilities of the AI assistant in the future.
+:::
+
+## How it works
+
+When you deploy a service to the [Defang Playground](./defang-playground.md), the Defang CLI will wait for the service's status to switch to healthy. If the service fails to deploy, the AI debugger will kick in. It will analyze the logs and files in your project to identify the issue and provide you with a suggested fix.
+
+:::warning
+The AI debugger currently only works in Playground. We plan to expand this to BYOC providers in the near future.
+:::
+
+:::info
+The AI debugger only kicks in when the service fails to deploy. This could be because of a build failure, healthchecks failing, or a variety of other issues. At the moment, we do not offer any way to trigger the AI debugger manually.
 :::
\ No newline at end of file
diff --git a/docs/concepts/defang-byoc.md b/docs/concepts/defang-byoc.md
index 6d2ac940b..2587387fe 100644
--- a/docs/concepts/defang-byoc.md
+++ b/docs/concepts/defang-byoc.md
@@ -38,9 +38,12 @@ Please read the [AWS Provider](../providers/aws/aws.md) documentation for more d
 ## DigitalOcean
 
 :::info
-The Private Beta of the Defang BYOC DigitalOcean Provider will be released in September 2024. Its development is tracked [here](https://github.com/DefangLabs/defang/pull/594).
+
+The Public Preview of the v1 Defang BYOC DigitalOcean Provider as of October 1 2024.
 :::
 
+Please read the [DigitalOcean Provider](../providers/digitalocean/digitalocean.md) documentation for more details about how the DigitalOcean provider works and how to get started.
+
 ## Azure
 
 :::info