[nongnu] elpa/cider a354b4c6b5 1/2: [Docs] Tweak the Scittle/nbb docs

[ELPA Syncer]

branch: elpa/cider
commit a354b4c6b50bdfff38ddc3a622636133ccab33f8
Author: Bozhidar Batsov <bozhidar@batsov.dev>
Commit: Bozhidar Batsov <bozhidar@batsov.dev>

    [Docs] Tweak the Scittle/nbb docs
---
 .../ROOT/pages/platforms/scittle_and_friends.adoc  | 36 ++++++++++++++++------
 1 file changed, 26 insertions(+), 10 deletions(-)

diff --git a/doc/modules/ROOT/pages/platforms/scittle_and_friends.adoc 
b/doc/modules/ROOT/pages/platforms/scittle_and_friends.adoc
index 5c72c6460a..0840dd7869 100644
--- a/doc/modules/ROOT/pages/platforms/scittle_and_friends.adoc
+++ b/doc/modules/ROOT/pages/platforms/scittle_and_friends.adoc
@@ -1,29 +1,45 @@
-= Scittle, Nbb, Joyride, and future plain repls
+= Scittle, Nbb, Joyride, and future (n)REPLs
 
-The default cider (clj-repl) should be capable of connecting to any
-nrepl server that provides minimal functionality.
+== The Problem
+
+CIDER was created in the early days of Clojure where there weren't any
+of the alternative implementation that exist today. This lead to a design
+that relied on knowledge of certain specifics of Clojure internal and
+the Clojure nREPL server.
+
+Later, with the introduction of ClojureScript we made another set
+of assumptions, related to the way hosted ClojureScript works. (e.g. that
+you start with an ordinary Clojure REPL that gets "upgraded" to a
+ClojureScript REPL by the invocation of a special form)
+
+Lately we've been working to address this and
+make CIDER more runtime-agnostic.
+
+== The Solution
+
+As of CIDER 1.3, the default CIDER connection command `cider-connect-clj` is
+capable of connecting to any nREPL server that provides minimal required
+functionality.
 
 As such, all of these work:
 https://github.com/babashka/nbb[nbb],
 https://github.com/babashka/scittle[scittle], 
https://github.com/BetterThanTomorrow/joyride[joyride]
 
-First start an nrepl server (the project's Readme usually has a section
-on starting a nrepl server).
+First start an nREPL server (the project's Readme usually has a section
+on starting a nREPL server).
 
 You can use
 
 kbd:[M-x `cider-connect-clj` <RET>]
 
-to connect to any plain Clojure(Script) nrepl server.
+to connect to any Clojure(Script) nREPL server.
 
 Features:
 
 * Eval, load file etc.
 * Errors as overlays. (The default cider error buffer is not implemented 
currently).
-* Other nrepl features the server provides; This might be rather minimal.
+* Other nREPL features the server provides; This might be rather minimal.
 
 Nbb, Scittle and Joyride all have quite cool completions already.
 
-== Note
-
-For nbb you can alternatively connect via cljs, see xref:platform/nbb.adoc[Nbb]
+NOTE: For nbb you can alternatively connect via cljs, see 
xref:platform/nbb.adoc[Nbb]