diff --git a/source/coral/files.cpp b/source/coral/files.cpp
index 3a0a87d..e2328ed 100755
--- a/source/coral/files.cpp
+++ b/source/coral/files.cpp
@@ -22,6 +22,8 @@ export namespace coral {
 
 	/**
 	 * Enumerates a file tree recursively, returning the absolute path of each file within.
+	 *
+	 * *Note*: file tree walking order is considered implementation-specific.
 	 */
 	struct file_walker : public enumerator<expected<slice<char const>, io_error>> {
 		virtual ~file_walker() {}