diff --git a/docs/cody/core-concepts/enterprise-architecture.mdx b/docs/cody/core-concepts/enterprise-architecture.mdx
index c67583176..c45a5073d 100644
--- a/docs/cody/core-concepts/enterprise-architecture.mdx
+++ b/docs/cody/core-concepts/enterprise-architecture.mdx
@@ -1,18 +1,23 @@
-# Enterprise architecture
+# Cody Enterprise architecture
 
-[Cody Enterprise](/cody/clients/enable-cody-enterprise) can run in the Sourcegraph Cloud environment or on your own infrastructure. Here are a few possible deployment architectures.
+<p className="subtitle">[Cody Enterprise](/cody/clients/enable-cody-enterprise) can be deployed via the Sourcegraph Cloud or on your self-hosted infrastructure. This page describes the architecture diagrams for Cody deployed in different Sourcegraph environments.</p>
 
 {/* Figma source: https://www.figma.com/file/lAPHpdhtEmOJ22IQXVZ0vs/Cody-architecture-diagrams-SQS-draft-2024-04?type=whiteboard&node-id=0-1&t=blg78H2YXXbdGSPc-0 */}
 
 ## Sourcegraph Cloud deployment
 
+This is a recommended deployment for Cody Enterprise. It uses the Sourcegraph Cloud infrastructure and Cody gateway.
+
 <img src="https://sourcegraphstatic.com/docs/enterprise-architecture-cloud-v2.png" />
 
 ## Sourcegraph Enterprise Server (self-hosted) on Amazon Bedrock
 
-<img src="https://sourcegraphstatic.com/docs/enterprise-architecture-aws-v0.png" />
+This is an example of a more complex deployment that uses Sourcegraph Enterprise Server (self-hosted) and Amazon Bedrock.
 
+<img src="https://sourcegraphstatic.com/docs/enterprise-architecture-aws-v0.png" />
 
 ## Data flow
 
-<img src="https://sourcegraphstatic.com/docs/enterprise-architecture-data-flow-v0.png" />
\ No newline at end of file
+The following diagram describes the data flow between the different components of Cody Enterprise.
+
+<img src="https://sourcegraphstatic.com/docs/enterprise-architecture-data-flow-v0.png" />