From 11f16bd1aaa496cccd9589ec553a00a2ad956419 Mon Sep 17 00:00:00 2001
From: me <me@localhost>
Date: Fri, 31 Jan 2020 10:57:30 +0200
Subject: [PATCH] [doc] improve docstring

---
 bumblebee/output.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/bumblebee/output.py b/bumblebee/output.py
index 6f14f90..6984a80 100644
--- a/bumblebee/output.py
+++ b/bumblebee/output.py
@@ -342,7 +342,13 @@ class I3BarOutput(object):
         sys.stdout.write("]\n")
 
     def draw(self, widget, module=None, engine=None):
-        """Draw a single widget"""
+        """
+            Draw a single widget
+
+            Note: technically, this method doesn't draw anything. It only adds
+            blocks of JSON text to self._widgets: one for separator, if the
+            theme contains a separator and one for the widget itself
+        """
         full_text = widget.full_text()
         if widget.get_module() and widget.get_module().hidden():
             return