Update rebl, remote-development, vim

Author: bpringe

docs/rebl.md

@@ -4,9 +4,7 @@
 
 ## Clojure CLI
 
-1.  Add your aliases to your deps.edn file. Use the deps.edn file in the `~/.clojure` directory to enable alias reuse across multiple projects.
-
-* Add the REBL and nREBL aliases to your deps.edn file. Below is the configuration for REBL on openjdk 12
+Add the following aliases to your deps.edn file. Use the deps.edn file in the `~/.clojure` directory to enable alias reuse across multiple projects. This is the configuration for REBL on openjdk 12. Check out the [REBL github page](https://github.com/cognitect-labs/REBL-distro) for more info.
 
 ```clojure
 ;; REBL Base
@@ -19,6 +17,7 @@
                 com.cognitect/rebl
                 ;; adjust to match your install location
                 {:local/root "/Users/ozimos/REBL/latest/REBL.jar"}}}
+
 ;; REBL 12
 :rebl-12
 {:extra-deps {org.openjfx/javafx-fxml     {:mvn/version "12.0.1"}
@@ -31,15 +30,11 @@
 
 ;; nREBL
 :nrebl {:extra-deps {rickmoynihan/nrebl.middleware {:mvn/version "0.2.0"}}
-            :main-opts ["-e" "((requiring-resolve,'cognitect.rebl/ui))" "-m" "nrepl.cmdline" "--middleware" "[nrebl.middleware/wrap-nrebl]" "-I"]}
+            :main-opts ["-e" "((requiring-resolve,'cognitect.rebl/ui))" "-m""nrepl.    cmdline" "--middleware" "[nrebl.middleware/wrap-nrebl]" "-I"]}
 ```
 
-Check out the [REBL github page](https://github.com/cognitect-labs/REBL-distro) for more info
-
-2. Create a Calva custom connect sequence for your VSCode editor
+Create a Calva custom connect sequence for your VSCode editor. (Read [Custom REPL Connect Sequences](connect-sequences.md) if you haven't.) Add the following to your vscode settings.json:
 
-* Read [Custom REPL Connect Sequences](connect-sequences.md) if you haven't
-* Add the following to your vscode settings.json
 ```json
 {
     "calva.replConnectSequences": [
@@ -59,10 +54,11 @@ Check out the [REBL github page](https://github.com/cognitect-labs/REBL-distro)
 ```
 ## Leiningen
 
-1. Add rebl profiles to your [user-wide profiles](https://github.com/technomancy/leiningen/blob/stable/doc/PROFILES.md#declaring-profiles) so that they will be available for all your projects.
-A sample user profile (located at `~/.lein/profiles.clj` on mac)
+Add rebl profiles to your [user-wide profiles](https://github.com/technomancy/leiningen/blob/stable/doc/PROFILES.md#declaring-profiles) so that they will be available for all your projects. Here's a sample user profile (located at `~/.lein/profiles.clj` on mac):
+
 ```clojure
 {:user {:plugins [[lein-ancient "0.6.15"]]}
+ 
  ;; REBL Base
  :rebl {:resource-paths ["/Users/ozimos/REBL/latest/REBL.jar"]
         :dependencies [[org.clojure/core.async "0.4.490"]
@@ -71,24 +67,22 @@ A sample user profile (located at `~/.lein/profiles.clj` on mac)
                        [cljfmt "0.6.4"]
                        [org.yaml/snakeyaml "1.23"]]}
 
-  ;; REBL 12 for JDK 12.0.1. Swap out for your JDK vaersion
+ ;; REBL 12 for JDK 12.0.1. Swap out for your JDK vaersion
  :rebl-12 {:dependencies [[org.openjfx/javafx-fxml  "12.0.1"]
                           [org.openjfx/javafx-controls "12.0.1"]
                           [org.openjfx/javafx-graphics "12.0.1"]
                           [org.openjfx/javafx-media "12.0.1"]
                           [org.openjfx/javafx-swing "12.0.1"]
                           [org.openjfx/javafx-base  "12.0.1"]
                           [org.openjfx/javafx-web "12.0.1"]]}
- ;; NREBL https://github.com/RickMoynihan/nrebl.middleware
+ 
+;; NREBL https://github.com/RickMoynihan/nrebl.middleware
  :nrebl {:repl-options {:nrepl-middleware [nrebl.middleware/wrap-nrebl]}
         :dependencies [[rickmoynihan/nrebl.middleware "0.3.1"]]}}
 ```
 [More info here](https://github.com/eccentric-j/lein-rebl-example)
 
-2. Create a Calva custom connect sequence for your VSCode editor
-
-* Read [Custom REPL Connect Sequences](connect-sequences.md) if you haven't
-* Add the following to your vscode settings.json
+Create a Calva custom connect sequence for your VSCode editor. (Read [Custom REPL Connect Sequences](connect-sequences.md) if you haven't.) Add the following to your vscode settings.json:
 
 ```json
 {

docs/remote-development.md

@@ -8,10 +8,10 @@ From a Clojure perspective it allows you to have VS Code installed on your Java-
 
 ## A use-case
 
-- for some reason your physical computer has to be running Windows (organisational rules etc.)
-- your deployment environment is Linux
-- you want to edit files in an editor running on your physical computer
-- most Clojure tooling is made with *nix first in mind and there are incompatibilities with Windows
+- For some reason your physical computer has to be running Windows (organizational rules etc.)
+- Your deployment environment is Linux
+- You want to edit files in an editor running on your physical computer
+- Most Clojure tooling is made with *nix first in mind and there are incompatibilities with Windows
 
 ## WSL
 

docs/vim.md

@@ -10,7 +10,7 @@ Calva's various structural selection commands [do not put VIM into VISUAL mode](
 
 In general Calva's default key bindings are not very VI-ish.
 
-You can add these keybindings to your `init.vim` if you are using the VSCode Neovim extension. It is inspired by and tries to emulate the keybindings found in [vim-fireplace](https://github.com/tpope/vim-fireplace) which is the most popular vim plugin for clojure.
+You can add these keybindings to your `init.vim` if you are using the VSCode Neovim extension. It is inspired by and tries to emulate the keybindings found in [vim-fireplace](https://github.com/tpope/vim-fireplace) which is the most popular vim plugin for Clojure.
 
 ```
 nmap cqp :call VSCodeNotify('calva.jackIn')<CR>
@@ -29,7 +29,7 @@ Calva binds **expand selection** to `ctrl+w`. This conflicts with the VIM Extens
 
 ### The `esc` key
 
-Calva binds the `esc` key to dismiss the display of inline results. This gets into conflict with any `vi` coding since `esc` then is used to go back to command mode. You can either fix Calva's default keybinding or the VIM extension.
+Calva binds the `esc` key to dismiss the display of inline results. This gets into conflict with any `vi` coding since `esc` then is used to go back to command mode. You can either change Calva's default keybinding or the VIM extension's.
 
 Alternatively, you can use the native Vim command `Ctrl + [` to escape and get back to command mode. Rebinding your keyboard's CapsLock key to Control may make this even easier.