diff --git a/docs/ai/extai.rst b/docs/ai/extai.rst
index 69c0ab34453..c72a5a06e22 100644
--- a/docs/ai/extai.rst
+++ b/docs/ai/extai.rst
@@ -1,11 +1,10 @@
 .. _ref_ai_extai_reference:
 
-============
-AI Extension
-============
+=======
+ext::ai
+=======
 
-This reference documents the |Gel| AI extension's components, configuration
-options, and APIs.
+This reference documents the |Gel| ``ext::ai`` extension components, configuration options, and database APIs.
 
 
 Enabling the Extension
@@ -43,7 +42,8 @@ Reset configuration:
 
 .. code-block:: edgeql
 
-    configure current branch reset ext::ai::Config::indexer_naptime;
+    configure current branch
+    reset ext::ai::Config::indexer_naptime;
 
 
 .. _ref_ai_extai_reference_ui:
@@ -93,10 +93,13 @@ Enables management of API configurations for AI API providers.
     :width: 100%
 
 
+Built-in resources
+==================
+
 .. _ref_ai_extai_reference_index:
 
 Index
-=====
+-----
 
 The ``ext::ai::index`` creates a deferred semantic similarity index of an
 expression on a type.
@@ -134,9 +137,6 @@ Parameters:
 * ``truncate_to_max``: bool (Default: False)
 
 
-Built-in resources
-==================
-
 .. _ref_ai_extai_reference_embedding_models:
 
 Embedding models
diff --git a/docs/ai/index.rst b/docs/ai/index.rst
index 6d40243427f..e1e4547325d 100644
--- a/docs/ai/index.rst
+++ b/docs/ai/index.rst
@@ -1,8 +1,10 @@
 .. _ref_ai_overview:
 
-======
-Gel AI
-======
+==
+AI
+==
+
+:edb-alt-title: Using Gel AI
 
 .. toctree::
     :hidden:
@@ -15,10 +17,8 @@ Gel AI
     extvectorstore
     vectorstore_python
 
-:edb-alt-title: Using Gel AI
-
 |Gel| AI is a set of tools designed to enable you to ship AI-enabled apps with
-practically no effort. This is what comes in the box:
+practically no effort.
 
 1. ``ext::ai``: this Gel extension automatically generates embeddings for your
    data. Works with OpenAI, Mistral AI, Anthropic, and any other provider with a
@@ -32,7 +32,5 @@ practically no effort. This is what comes in the box:
 3. Python library: ``gel.ai``. Access all Gel AI features straight from your
    Python application.
 
-4. JavaScript library: ``@gel/ai``.
-
-
-
+4. JavaScript library: ``@gel/ai``. Access all Gel AI features right from your
+   JavaScript backend application.