Apply suggestions from code review

Author: Oxyjun

src/content/changelog/ai-search/2025-10-27-ai-search-reranking-system-prompt.mdx

@@ -8,7 +8,7 @@ date: 2025-10-28
 
 [AI Search](/ai-search/) now supports reranking for improved retrieval quality and allows you to set the system prompt directly in your API requests.
 
-## Reranking for more relevant results
+## Rerank for more relevant results
 
 You can now enable [reranking](/ai-search/configuration/reranking/) to reorder retrieved documents based on their semantic relevance to the user’s query. Reranking helps improve accuracy, especially for large or noisy datasets where vector similarity alone may not produce the optimal ordering.
 

src/content/docs/ai-search/configuration/reranking.mdx

@@ -5,6 +5,8 @@ sidebar:
   order: 4
 ---
 
+import { DashButton } from "~/components";
+
 Reranking can help improve the quality of AI Search results by reordering retrieved documents based on semantic relevance to the user’s query. It applies a secondary model after retrieval to "rerank" the top results before they are outputted.
 
 ## How it works
@@ -14,7 +16,7 @@ By default, reranking is **disabled** for all AI Search instances. You can enabl
 When enabled, AI Search will:
 
 1. Retrieve a set of relevant results from your index, constrained by your `max_num_of_results` and `score_threshold` parameters.  
-2. Pass those results through a [reranking model](/ai-search/configuration/models/supported-models/)
+2. Pass those results through a [reranking model](/ai-search/configuration/models/supported-models/).
 3. Return the reranked results, which the text generation model can use for answer generation.
 
 Reranking helps improve accuracy, especially for large or noisy datasets where vector similarity alone may not produce the optimal ordering.
@@ -47,15 +49,26 @@ const answer = await env.AI.autorag("my-autorag").aiSearch({
 
 When creating a new RAG in the dashboard:
 
-1. In the Retrieval configuration step, open the Reranking dropdown
-2. Toggle Reranking on
-3. Select the reranking model
+1. Go to **AI Search** in the Cloudflare dashboard.
+
+   <DashButton url="/?to=/:account/ai/ai-search" />
+   
+2. Select **Create** > **Get started**.
+3. In the **Retrieval configuration** step, open the **Reranking** dropdown.
+4. Toggle **Reranking** on.
+5. Select the reranking model.
+6. Complete your setup.
 
 ### Configure in dashboard for existing AI Search
 
 To update reranking for an existing instance:
 
-1. Go to your AI Search instance
-2. Open the Settings tab
-3. Enable or disable reranking, and select the reranking model
+1. Go to **AI Search** in the Cloudflare dashboard.
+
+   <DashButton url="/?to=/:account/ai/ai-search" />
+
+2. Select an existing AI Search instance.
+3. Go to the **Settings** tab.
+4. Under **Reranking**, toggle reranking on.
+5. Select the reranking model.
 

src/content/docs/ai-search/configuration/system-prompt.mdx

@@ -47,12 +47,16 @@ const answer = await env.AI.autorag("my-autorag").aiSearch({
 });
 ```
 
+import { DashButton } from "~/components";
+
 ### Configure via Dashboard
-The system prompt for your AI Search can be set after it has been created by:
+The system prompt for your AI Search can be set after it has been created:
 
-1. Navigating to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/ai/autorag), and go to AI > AI Search
-2. Select your AI Search
-3. Go to Settings page and find the System prompt setting for either Query rewrite or Generation
+1. Go to **AI Search** in the Cloudflare dashboard.
+   <DashButton url="/?to=/:account/ai/ai-search" />
+2. Select an existing AI Search instance.
+3. Go to the **Settings** tab.
+4. Go to **Query rewrite** or **Generation**, and edit the **System prompt**.
 
 ## Query rewriting system prompt