diff --git a/doc/config.cmake b/doc/config.cmake
index bac5a490..b5aaa9b5 100644
--- a/doc/config.cmake
+++ b/doc/config.cmake
@@ -121,27 +121,34 @@ format = <label-state> <label-mode>
 index-sort = true
 wrapping-scroll = false
 
+; Only show workspaces on the same output as the bar
+;pin-workspaces = true
+
 label-mode-padding = 2
 label-mode-foreground = #000
 label-mode-background = ${colors.primary}
 
+; focused = Active workspace on focused monitor
 label-focused = %index%
 label-focused-background = ${module/bspwm.label-focused-background}
 label-focused-underline = ${module/bspwm.label-focused-underline}
 label-focused-padding = ${module/bspwm.label-focused-padding}
 
+; unfocused = Inactive workspace on any monitor
 label-unfocused = %index%
 label-unfocused-padding = ${module/bspwm.label-occupied-padding}
 
-label-urgent = %index%!
-label-urgent-background = ${module/bspwm.label-urgent-background}
-label-urgent-padding = ${module/bspwm.label-urgent-padding}
-
+; visible = Active workspace on unfocused monitor
 label-visible = %index%
 label-visible-background = ${self.label-focused-background}
 label-visible-underline = ${self.label-focused-underline}
 label-visible-padding = ${self.label-focused-padding}
 
+; urgent = Workspace with urgency hint set
+label-urgent = %index%
+label-urgent-background = ${module/bspwm.label-urgent-background}
+label-urgent-padding = ${module/bspwm.label-urgent-padding}
+
 [module/mpd]
 type = internal/mpd
 format-online = <label-song>  <icon-prev> <icon-stop> <toggle> <icon-next>
diff --git a/include/modules/i3.hpp b/include/modules/i3.hpp
index 1cce79b2..0de0c64e 100644
--- a/include/modules/i3.hpp
+++ b/include/modules/i3.hpp
@@ -3,7 +3,6 @@
 #include <i3ipc++/ipc.hpp>
 
 #include "components/config.hpp"
-#include "settings.hpp"
 #include "modules/meta/event_module.hpp"
 #include "modules/meta/input_handler.hpp"
 #include "utils/i3.hpp"
@@ -16,9 +15,21 @@ namespace modules {
    public:
     enum class state {
       NONE,
+      /**
+       * @brief Active workspace on focused monitor
+       */
       FOCUSED,
+      /**
+       * @brief Inactive workspace on any monitor
+       */
       UNFOCUSED,
+      /**
+       * @brief Active workspace on unfocused monitor
+       */
       VISIBLE,
+      /**
+       * @brief Workspace with urgency hint set
+       */
       URGENT,
     };