X-Git-Url: https://git.xandkar.net/?a=blobdiff_plain;f=README.md;h=62036c9eb2a2a356a80507768e00b262e0623f05;hb=7daecd248d2531ed281841958525364e3c6d1c4b;hp=df43d383c8ae00143caafa49dc8ac721badd1e96;hpb=61c33dc2a67fbadd9a9a401a759fb81e1e33cc71;p=khatus.git

diff --git a/README.md b/README.md
index df43d38..62036c9 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,44 @@
 khatus
 ======
+![mascot](mascot.jpg)
 
-My ad-hoc, text-only status bar scripts I use with
+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 ~
+                            ~~~~~~
+```
+
+Any errors encountered by any sensor are propagated as alerts by the
+controller, which are in turn actualized as desktop notifications by the
+actuator:
+![screenshot-self-error-propagation](screenshot-self-error-propagation.jpg)