Add some more details on documentation

Author: ardumont

README.org

@@ -1,9 +1,7 @@
 #+title: psci-mode
 #+author: ardumont
 
-At the moment, not everything works.
-
-For example, the `:r` command (which is supposed to reset the loaded modules of the current session) does nothing (but it does work in a terminal session).
+A major mode to try and improve the purescript repl experience within emacs.
 
 * Description
 ** What
@@ -95,14 +93,14 @@ M-x el-get-install RET psci RET
 
 *Note* Providing [[https://github.com/dimitri/el-get/pull/1973][PR]] is merged.
 
-* Setup
+* Start and setup
 ** Start
 
 #+begin_src sh
 M-x psci
 #+end_src
 
-This will open a psci repl in your project root folder (using projectile to determine that).
+This will open a psci repl within emacs from your current project root folder (using [[https://github.com/bbatsov/projectile][projectile]] to determine that).
 
 ** Setup
 
@@ -117,18 +115,20 @@ This permits, using the same universal binding `C-c C-z`, to go back and forth b
 
 * Use
 
-Default bindings for this mode:
+Default bindings available from a purescript buffer:
 
 |-------------+--------------------------------+----------------------------------------------------------------------------------------------|
 | Keybindings | Interactive commands           | Description                                                                                  |
 |-------------+--------------------------------+----------------------------------------------------------------------------------------------|
-| C-c C-l     | M-x psci/load-current-file!    | Equivalent of `:m /path/to/current/module/file.purs`                                         |
-| C-c M-n     | M-x psci/load-module!          | Equivalent of `:i your.current.module.name`                                                  |
-| C-c C-r     | M-x psci/load-project-modules! | Load or reload modules defined in your project file .psci                                    |
-| N/A         | M-x psci/reset!                | Equivalent of `:r`                                                                           |
+| C-c C-l     | M-x psci/load-current-file!    | Equivalent of `:m /path/to/current/module/file.purs` - Load <file> for importing             |
+| C-c M-n     | M-x psci/load-module!          | Equivalent of `:i your.current.module.name` - Import <module> for use in PSCI                |
+| C-c C-r     | M-x psci/load-project-modules! | Load or reload files defined in the project file .psci                                       |
+| N/A         | M-x psci/reset!                | Equivalent of `:r` - Reset                                                                   |
 | C-c C-z     |                                | Provided you use the previous setup, this will switch back and forth between repl and buffer |
 |-------------+--------------------------------+----------------------------------------------------------------------------------------------|
 
+
+
 * Runtime dependencies
 
 A purescript dev platform ready.