diff --git a/docs/src/performance.md b/docs/src/performance.md
index bcd9da1a59533469758d309cb19b8dec30bab012..9dff1d7f5ff0961d33169ee5c8761016d8fb7564 100644
--- a/docs/src/performance.md
+++ b/docs/src/performance.md
@@ -1,10 +1,19 @@
 How to use our internal tools to profile and keep Zed fast.
 
-# Tracy
+# Flamechart/CPU profiling
 
-Get a profile of the zed foreground executor
+See what the CPU spends the most time on. Strongly recommend you use
+[samply](https://github.com/mstange/samply). It opens an interactive profile in
+the browser. See its README on how to install and run.
 
-The profiler always runs in the background. You can save a trace from its UI or look at the results live.
+# Task/Async profiling
+
+Get a profile of the zed foreground executor and background executors. Check if
+anything is blocking the foreground too long or taking too much (clock) time in
+the background.
+
+The profiler always runs in the background. You can save a trace from its UI or
+look at the results live.
 
 ## Setup/Building the importer: