diff --git a/.vortex-core/README.md b/.vortex-core/README.md
index 406be3b..5bf4ef2 100644
--- a/.vortex-core/README.md
+++ b/.vortex-core/README.md
@@ -4,6 +4,8 @@ Keyboard configuration for the Vortex Core 40% keyboard.
 
 Generated using [TsFreddie's MPC tool](https://tsdo.in/much-programming-core/).
 
+Note: this is assuming `Caps lock` is remapped to `Esc` on press and `Ctrl` on hold (e.g. using `caps2esc`).
+
 ## Layer 0
 
 Macros are mainly used for shift, ctrl & alt modifiers.