diff --git a/docs/docs/tools/improve.md b/docs/docs/tools/improve.md
index bdc83630..b9ea8417 100644
--- a/docs/docs/tools/improve.md
+++ b/docs/docs/tools/improve.md
@@ -598,6 +598,10 @@ Note: Chunking is primarily relevant for large PRs. For most PRs (up to 600 line
         <td><b>num_code_suggestions_per_chunk</b></td>
         <td>Number of code suggestions provided by the 'improve' tool, per chunk. Default is 3.</td>
       </tr>
+      <tr>
+        <td><b>num_best_practice_suggestions 💎</b></td>
+        <td>Number of code suggestions provided by the 'improve' tool for best practices. Default is 1.</td>
+      </tr>
       <tr>
         <td><b>max_number_of_calls</b></td>
         <td>Maximum number of chunks. Default is 3.</td>