diff --git a/.config/sxhkd/sxhkdrc b/.config/sxhkd/sxhkdrc
index 6ee67fe..45ca8d8 100644
--- a/.config/sxhkd/sxhkdrc
+++ b/.config/sxhkd/sxhkdrc
@@ -53,6 +53,20 @@ super + g
 #
 # state/flags
 #
+# STATES:
+# tiled:        its position and size are determined by the window tree
+# pseudo_tiled: a tiled window that automatically shrinks but doesn't
+#               stretch bezond its floating size
+# floating:     can be moved/resized freely. Still part of the window tree
+# fullscreen:   fills monitor rectangle and has no borders
+# FLAGS:
+# hidden:       is hidden and doesn't occupy any tiling space
+# sticky:       stays in the focused desktop of its monitor
+# private:      tries to keep the same tiling position/size
+# locked:       ignores the node --close message
+# marked:       useful for deferred actions. A marked node becomes unmarked
+#               after being sent on a preselected node
+# urgent:       has its urgency hint set. This flag is set externally
 
 # set the window state
 super + {t,shift + t,s,f}