README.md: Update intro

diff --git a/README.md b/README.md
index 7e7cf3fc8eacc6f32787ebe505904a0f191d47b4..babcf9bc0bb902086d63d0fac6834be3e643f3fb 100644 (file)
--- a/README.md
+++ b/README.md
@@ -5,6 +5,8 @@ bindings with a common prefix - a Hydra.
 
 ![hydra](http://oremacs.com/download/Hydra.jpg)
 
+## Description for Poets
+
 Once you summon the Hydra through the prefixed binding (the body + any one head), all heads can be
 called in succession with only a short extension.
 
@@ -13,6 +15,20 @@ Hercules, besides vanquishing the Hydra, will still serve his original purpose,
 command.  This makes the Hydra very seamless, it's like a minor mode that disables itself
 auto-magically.
 
+## Description for Pragmatics
+
+Imagine that you have bound <kbd>C-c j</kbd> and <kbd>C-c k</kbd> in your
+config.  You want to call <kbd>C-c j</kbd> and <kbd>C-c k</kbd> in some
+(arbitrary) sequence. Hydra allows you to:
+
+- Bind your functions in a way that pressing <kbd>C-c jjkk3j5k</kbd> is
+equivalent to pressing <kbd>C-c j C-c j C-c k C-c k M-3 C-c j M-5 C-c
+k</kbd>. Any key other than <kbd>j</kbd> or <kbd>k</kbd> exits this state.
+
+- Assign a custom hint to this group of functions, so that you know immediately
+after pressing <kbd>C-c</kbd> that you can follow up with <kbd>j</kbd> or
+<kbd>k</kbd>.
+
 If you want to quickly understand the concept, see [the video demo](https://www.youtube.com/watch?v=_qZliI1BKzI).
 
 <!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc/generate-toc again -->