diff --git a/core/container/small_array/doc.odin b/core/container/small_array/doc.odin
index 21d000a10..5696ae58c 100644
--- a/core/container/small_array/doc.odin
+++ b/core/container/small_array/doc.odin
@@ -1,4 +1,6 @@
 /*
+Deprecation Notice: Prefer using `[dynamic; N]T` (fixed capacity dynamic arrays).
+
 A dynamic array-like interface on a stack-allocated, fixed-size array.
 
 The `Small_Array` type is optimal for scenarios where you need