[elpa] master b2c9ea6 36/45: README.md: Update intro

[Oleh Krehel]

branch: master
commit b2c9ea6f9969f09b4d686e350a232f566710b3b2
Author: Oleh Krehel <address@hidden>
Commit: Oleh Krehel <address@hidden>

    README.md: Update intro
---
 README.md |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)

diff --git a/README.md b/README.md
index 7e7cf3f..babcf9b 100644
--- 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 -->