diff --git a/docs/docs/core-abilities/rag_context_enrichment.md b/docs/docs/core-abilities/rag_context_enrichment.md
index a6ba038f..a2064c3f 100644
--- a/docs/docs/core-abilities/rag_context_enrichment.md
+++ b/docs/docs/core-abilities/rag_context_enrichment.md
@@ -1,6 +1,6 @@
 # RAG Context Enrichment 💎
 
-`Supported Git Platforms: GitHub`
+`Supported Git Platforms: GitHub, Bitbucket Data Center`
 
 !!! info "Prerequisites"
     - RAG is available only for Qodo enterprise plan users, with single tenant or on-premises setup.
diff --git a/docs/docs/tools/improve.md b/docs/docs/tools/improve.md
index f190990c..72753b59 100644
--- a/docs/docs/tools/improve.md
+++ b/docs/docs/tools/improve.md
@@ -267,14 +267,19 @@ In such cases, we recommend prioritizing the suggestion's detailed description,
 
 > `💎 feature` Platforms supported: GitHub, GitLab
 
-If you set the following in your configuration file:
+Enable interactive code discussions by adding this to your configuration file (default `True`):
 
 ```toml
 [pr_code_suggestions]
 enable_chat_in_code_suggestions = true
 ```
 
-The Qodo Merge bot will automatically listen and respond to comments within code suggestion discussions that it has initiated, without requiring explicit tool calls.
+The Qodo Merge implements an orchestrator agent to listen and respond to comments within code suggestion discussions that it has initiated, without requiring explicit tool calls.
+The orchestrator intelligently analyzes your responses to determine if you want to implement a suggestion, ask a question, or request help, then delegates to the appropriate specialized tool.
+
+For example:
+
+![Chat on code suggestions ](https://codium.ai/images/pr_agent/improve_chat_on_code_suggestions.png){width=512}
 
 
 ### Dual publishing mode