diff --git a/Cargo.toml b/Cargo.toml
index ea373d8..3ca0f5f 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -43,6 +43,9 @@ serde_yaml = "0.9"
 toml_edit = { version = "0.22", features = ["serde"] }
 
 [build-dependencies]
+# NOTE: even though we use embed-resource for windows only, we can't move it into
+# a [target[...]build-dependencies] block because in case of cross-compiling, the
+# build.rs will be compiled for a different, non-windows arch than the main executable.
 embed-resource = "1.6.3"  # embedding of .exe metadata
 
 [features]