diff --git a/lib/std/fs/path.zig b/lib/std/fs/path.zig
index c01a40be469d..bc74eaa7e1fb 100644
--- a/lib/std/fs/path.zig
+++ b/lib/std/fs/path.zig
@@ -468,7 +468,8 @@ fn asciiEqlIgnoreCase(s1: []const u8, s2: []const u8) bool {
 }
 
 /// On Windows, this calls `resolveWindows` and on POSIX it calls `resolvePosix`.
-/// Note: Dont use for symlinks, because Windows and Posix having different behavior.
+/// Note: Symlinks currently dont work and should not be used,
+/// because Windows and Posix having different behavior.
 /// On Windows, symlinks are resolved after `..` is resolved.
 /// On POSIX, symlinks are resolved eagerly.
 pub fn resolve(allocator: Allocator, paths: []const []const u8) ![]u8 {