diff --git a/src/config/Config.zig b/src/config/Config.zig
index 8ba3b02c1..f9913e440 100644
--- a/src/config/Config.zig
+++ b/src/config/Config.zig
@@ -316,6 +316,11 @@ keybind: Keybinds = .{},
 /// Changing this value will not affect the size of the window after
 /// it has been created. This is only used for the initial size.
 ///
+/// BUG: On Linux with GTK, the calculated window size will not properly
+/// take into account window decorations. As a result, the grid dimensions
+/// will not exactly match this configuration. If window decorations are
+/// disabled (see window-decorations), then this will work as expected.
+///
 /// Windows smaller than 10 wide by 4 high are not allowed.
 @"window-height": u32 = 0,
 @"window-width": u32 = 0,