diff --git a/core/debug/trace/doc.odin b/core/debug/trace/doc.odin
index a2409caa4..b6044296d 100644
--- a/core/debug/trace/doc.odin
+++ b/core/debug/trace/doc.odin
@@ -1,6 +1,12 @@
 /*
 Captures and resolves stack traces for debugging purpose.
 
+Debug info based support is implemented for Windows, MacOS, and Linux.
+
+Other targets can use the instrumentation based mode, which uses Odin's instrumentation
+features to trace, with some runtime overhead.
+Opt in with `-define:ODIN_TRACE_INSTRUMENTATION_MODE=true`.
+
 Example:
 	package main