move comment into markdown.ts

Author: bdemann

.github/scripts/analyze_benchmarks/markdown.ts

@@ -16,12 +16,24 @@ export async function generateMarkdownReport(): Promise<string> {
         })
     );
 
-    return `# Benchmarks
+    return `<!--
+This file is auto-generated by .github/scripts/analyze_benchmarks/markdown.ts
+Do not edit this file manually. Changes will be overwritten.
+-->
+
+# Benchmarks
+
+## Purpose and Usage
+
+This document tracks high-level performance changes across Azle versions for comparison between releases.
+
+**For detailed benchmarks showing how different Candid data types perform, see the [benchmarks example](examples/stable/test/end_to_end/candid_rpc/benchmarks/benchmarks.md).** This is the best resource for understanding day-to-day performance in your Azle applications.
 
 ${generateVersionTables(sortedBenchmarks)}
 
 ---
-*Report generated automatically by Azle*`;
+
+_Report generated automatically by Azle_`;
 }
 
 function generateVersionTables(