From c570284ace0ed5f1f254f9cc475a30f4be56af0f Mon Sep 17 00:00:00 2001
From: shoshin <shoshin@cicadas.surf>
Date: Sun, 17 Jul 2022 11:49:01 -0500
Subject: Add: which-key notes, embark prefix help, inf-ruby package

---
 shoshin-config.el  |  2 ++
 shoshin-config.org | 28 ++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/shoshin-config.el b/shoshin-config.el
index c92396f..7834edd 100644
--- a/shoshin-config.el
+++ b/shoshin-config.el
@@ -142,6 +142,8 @@
 
 (package-install 'json-mode)
 
+(package-install 'inf-ruby)
+
 (package-install 'devdocs)
 
 ;;; Projects
diff --git a/shoshin-config.org b/shoshin-config.org
index 8d381ea..9c05ae3 100644
--- a/shoshin-config.org
+++ b/shoshin-config.org
@@ -445,6 +445,9 @@ perspective-local buffers where the perspective was tied to a project.
 
 #+begin_src emacs-lisp
   (package-install 'embark)
+  (package-install 'embark-consult)
+  (global-set-key (kbd "C-;") #'embark-act)
+  (setq prefix-help-command #'embark-prefix-help-command)
 #+end_src
 
 ** marginalia
@@ -502,6 +505,23 @@ this is implemented with the ~vertico-directory~ extension.
 #+end_src
 ** which-key
 
+which-key is an excellent package that helps provide guide posts for command
+discoverability. many key commands in Emacs are in sequences. for example,
+~org-babel-tangle~ is ~C-c C-v t~. as a user, the commands you use often
+become muscle memory, or you map them to something more convienient. but
+sometimes you know there is some command to do what you want but you don't
+quite remember what the sequence is. or perhaps you're in a new major-mode
+and you know there must be several handy commands under ~C-c~. ~which-key~
+pops up a buffer with a listing of all the possible continuations from where
+you are in a key sequence. for that reason, it can be useful at times even
+for experienced users.
+
+this config installs which-key, but does not activate it automatically.
+some advice from Daniel Mendler (consult author) suggested that limiting the
+amount Emacs pops things up automatically is a better user experience.
+which-key is just a toggle away when needed, and there is also [[*embark][embark]]
+which has a command to show prefix key continuations.
+
 #+begin_src emacs-lisp
   (package-install 'which-key)
   (which-key-mode)
@@ -583,6 +603,14 @@ from them in various Emacs menus. [[*\[\[info:consult#Top\]\[consult\]\] - Consu
 #+end_src
 
 *** Ruby
+**** inf-ruby
+
+inf-ruby provides an interface to the various REPLs available in the Ruby-verse
+its currently provided by non-gnu ELPA:
+
+#+begin_src emacs-lisp
+  (package-install 'inf-ruby)
+#+end_src
 
 ** Dev Docs
 #+begin_src emacs-lisp
-- 
cgit v1.2.3