Document cider-selector

Author: bbatsov

doc/modules/ROOT/pages/usage/misc_features.adoc

@@ -115,6 +115,65 @@ and `cider-ns-reload-all` commands can be used instead. These commands
 invoke Clojure's `+(require ... :reload)+` and `+(require
 ... :reload-all)+` commands at the REPL.
 
+== CIDER Selector
+
+The `cider-selector` (kbd:[C-c M-s]) command allows you to quickly navigate to
+important buffers in the context of a Clojure project - e.g. the REPL, the
+stacktrace buffer, the doc buffer, the most recently visited Clojure file, etc.
+The usage of the command is extremely simple - after invoking you need to type a
+single key identifying the target buffer (e.g. `r` for the REPL).
+
+Here's a list of all of `cider-selectors`'s keybindings:
+
+|===
+| Keyboard shortcut | Description
+
+| kbd:[c]
+| Most recently visited Clojure buffer.
+
+| kbd:[e]
+| Most recently visited Emacs Lisp buffer.
+
+| kbd:[r]
+| Current REPL buffer or most recently visited REPL buffer.
+
+| kbd:[m]
+| `+*nrepl-messages*+` buffer.
+
+| kbd:[x]
+| `+*cider-error*+` buffer.
+
+| kbd:[d]
+| `+*cider-doc*+` buffer.
+
+| kbd:[p]
+| `+*cider-profiler*+` buffer.
+
+| kbd:[s]
+| `+*cider-scratch*+` buffer.
+
+| kbd:[q]
+| Abort.
+
+| kbd:[h]
+| Show help.
+|===
+
+[TIP]
+====
+Any of those keys can be prefixed with a `4` to make the target buffer open in a
+different window (as opposed to the current one).
+====
+
+You can easily extend the selector with new commands using `def-cider-selector-method`:
+
+[source,lisp]
+----
+(def-cider-selector-method ?z
+  "CIDER foo buffer."
+  cider-foo-buffer)
+----
+
 == Browsing the Classpath
 
 You can easily browse the items on your classpath with the command