diff --git a/include/events/signal.hpp b/include/events/signal.hpp
index a984a8eb..98e00198 100644
--- a/include/events/signal.hpp
+++ b/include/events/signal.hpp
@@ -120,9 +120,11 @@ namespace signals {
     struct request_snapshot : public detail::value_signal<request_snapshot, string> {
       using base_type::base_type;
     };
+    /// emitted whenever the desktop background slice changes
     struct update_background : public detail::base_signal<update_background> {
       using base_type::base_type;
     };
+    /// emitted when the bar geometry changes (such as position of the bar on the screen)
     struct update_geometry : public detail::base_signal<update_geometry> {
       using base_type::base_type;
     };