diff --git a/docs/docs/tools/describe.md b/docs/docs/tools/describe.md
index 4f4e2232..03cb0c62 100644
--- a/docs/docs/tools/describe.md
+++ b/docs/docs/tools/describe.md
@@ -1,18 +1,6 @@
 ## Overview
 
 The `describe` tool scans the PR code changes, and generates a description for the PR - title, type, summary, walkthrough and labels.
-### Mermaid Diagram Support 
-When the `add_diagram` option is enabled in your configuration, the `/describe` tool will include a `Mermaid` sequence diagram in the PR description.
-
-This diagram represents interactions between components/functions based on the diff content.
-
-### How to enable
-
-In your configuration:
-
-toml
-[pr_description]
-add_diagram = true
 
 The tool can be triggered automatically every time a new PR is [opened](../usage-guide/automations_and_usage.md#github-app-automatic-tools-when-a-new-pr-is-opened), or it can be invoked manually by commenting on any PR:
 
@@ -68,6 +56,19 @@ Everything below this marker is treated as previously auto-generated content and
 
 ![Describe comment](https://codium.ai/images/pr_agent/pr_description_user_description.png){width=512}
 
+### Sequence Diagram Support 
+When the `add_diagram` option is enabled in your configuration, the `/describe` tool will include a `Mermaid` sequence diagram in the PR description.
+
+This diagram represents interactions between components/functions based on the diff content.
+
+### How to enable
+
+In your configuration:
+
+toml
+[pr_description]
+add_diagram = true
+
 ## Configuration options
 
 !!! example "Possible configurations"