[Docs] Improve the docs about self-hosted ClojureScript REPLs

Author: bbatsov

doc/modules/ROOT/nav.adoc

@@ -14,7 +14,7 @@
 ** xref:platforms/overview.adoc[Overview]
 ** xref:platforms/babashka.adoc[Babashka]
 ** xref:platforms/nbb.adoc[Nbb]
-** xref:platforms/scittle_and_friends.adoc[Scittle and Friends]
+** xref:platforms/other_platforms.adoc[Other Platforms]
 * Using CIDER
 ** xref:usage/interactive_programming.adoc[Interactive Programming]
 ** xref:usage/cider_mode.adoc[Using cider-mode]

doc/modules/ROOT/pages/cljs/other_repls.adoc

@@ -86,3 +86,23 @@ and insert `dev`.
 . Connect to the running server with your browser. The address is printed on the terminal, but it's probably `+http://localhost:3000+`.
 
 For more information visit https://github.com/adzerk-oss/boot-cljs-repl[boot-cljs-repl].
+
+== nbb (node.js babashka)
+
+CIDER has built-in support for `nbb`. You can either jack in to an nbb project with `M-x clojure-jack-in-cljs`.
+
+or start its bundled nREPL server:
+
+  $ nbb nrepl-server
+
+and connect to it afterwards using `M-x cider-connect-cljs`.
+
+See the xref:platforms/nbb.adoc[dedicated page] for more details.
+
+== Other Self-hosted REPLs
+
+For all other self-hosted REPLs you can follow the instructions xref:platforms/other_platforms.adoc[here]. This will work fine with any well-behaved nREPL implementation, like those of:
+
+* https://github.com/babashka/nbb[nbb]
+* https://github.com/babashka/scittle[scittle]
+* https://github.com/BetterThanTomorrow/joyride[joyride]

doc/modules/ROOT/pages/platforms/babashka.adoc

@@ -1,6 +1,12 @@
 = Babashka
 
-Babashka is highly compatible with Clojure, so it works with CIDER out of the box. All you need to do
+== Overview
+
+Babashka is highly compatible with Clojure, so it works with CIDER out of the box.
+
+== Usage
+
+All you need to do
 is start its bundled nREPL server:
 
   $ bb --nrepl-server

doc/modules/ROOT/pages/platforms/nbb.adoc

@@ -1,13 +1,19 @@
 = https://github.com/babashka/nbb[nbb]
 
-Nbb's main goal is to make it easy to get started with ad hoc CLJS scripting on Node.js.
+== Overview
+
+Nbb's main goal is to make it easy to get started with ad hoc ClojureScript scripting on Node.js.
 
 It is highly compatible with ClojureScript, so it works with CIDER out of the box.
 
+== Usage
+
 You can either jack in to an nbb project with `M-x clojure-jack-in-cljs`.
 
 or start its bundled nREPL server:
 
   $ nbb nrepl-server
 
 and connect to it afterwards using `M-x cider-connect-cljs`.
+
+NOTE: `cider-jack-in-cljs` works with nbb projects that are using `nbb.edn`.

doc/modules/ROOT/pages/platforms/scittle_and_friends.adoc renamed to doc/modules/ROOT/pages/platforms/other_platforms.adoc

@@ -1,4 +1,4 @@
-= Scittle, Nbb, Joyride, and future (n)REPLs
+= Other Platforms
 
 == The Problem
 
@@ -18,12 +18,14 @@ make CIDER more runtime-agnostic.
 == The Solution
 
 As of CIDER 1.6, the default CIDER connection command `cider-connect-clj` is
-capable of connecting to any nREPL server that provides minimal required
-functionality.
+capable of connecting to any nREPL server that implements the core nREPL
+protocol interface.
 
 As such, all of these work:
-https://github.com/babashka/nbb[nbb],
-https://github.com/babashka/scittle[scittle], https://github.com/BetterThanTomorrow/joyride[joyride]
+
+* 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).
@@ -37,9 +39,10 @@ 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).
+* Code completion.
+* Errors as overlays. (The default CIDER error buffer is not implemented currently).
 * Other nREPL features the server provides; This might be rather minimal.
 
-Nbb, Scittle and Joyride all have quite cool completions already.
+Basically you'll get every feature that's implemented by the nREPL server you're using.
 
-NOTE: For nbb you can alternatively connect via cljs, see xref:platform/nbb.adoc[Nbb]
+NOTE: For nbb you can alternatively connect via `cider-connect-cljs`, see xref:platform/nbb.adoc[nbb].