diff --git a/include/wlr/types/wlr_xdg_shell.h b/include/wlr/types/wlr_xdg_shell.h
index 8c1bda058..a67f32ac2 100644
--- a/include/wlr/types/wlr_xdg_shell.h
+++ b/include/wlr/types/wlr_xdg_shell.h
@@ -256,7 +256,9 @@ struct wlr_xdg_surface {
 
 	struct wlr_xdg_surface_state current, pending;
 
+	// Whether the surface is ready to receive configure events
 	bool initialized;
+	// Whether the latest commit is an initial commit
 	bool initial_commit;
 
 	struct {