X-Git-Url: https://git.xandkar.net/?a=blobdiff_plain;f=README.md;h=72512e9ab2997c117e61c909d9bff53403f8a5e3;hb=55407653a1b516622c330af3d47963ecbba0fb61;hp=cb7f3e33175c9b601b1bc93ce094e2f2f2ef4d83;hpb=756b9d5a05cbd36f97b1cb817137148517e14abf;p=khatus.git

diff --git a/README.md b/README.md
index cb7f3e3..72512e9 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,39 @@
 khatus
 ======
+![mascot](mascot.jpg)
 
-My ad-hoc, text-only status bar scripts I use with `dwm` on GNU/Linux.
+Experimental, system monitor and status (bar) reporter I use with
+[dwm](https://dwm.suckless.org/) on GNU/Linux.
 
 ![screenshot](screenshot.jpg)
+
+
+Design
+------
+
+```
+ parallel   +----------+  +----------+     +----------+
+ stateless  | sensor_1 |  | sensor_2 | ... | sensor_n |
+ collectors +----------+  +----------+     +----------+
+                |             |                 |
+              data          data              data
+                |             |                 |
+                V             V                 V
+ serial     +-----------------------------------------+
+ stateful   |              controller                 |
+ observer   +-----------------------------------------+
+                              |
+                          decisions
+                              |
+                              V
+ serial     +-----------------------------------------+
+ stateless  |              actuator                   |
+ executor   +-----------------------------------------+
+                              |
+                        system commands
+                              |
+                              V
+                            ~~~~~~
+                            ~ OS ~
+                            ~~~~~~
+```