some docs updates around development

Author: bollwyvl

README.md

@@ -156,23 +156,37 @@ jupyter labextension install @krassowski/jupyterlab-lsp@0.5.0-rc.0
 
 ## Development
 
-For a development install (requires npm version 4 or later), do the following in the repository directory:
+For a development install (requires `nodejs` 8 or later and `jupyterlab` 1.1),
+run the following in the repository directory:
 
 ```bash
-npm install
-npm run build
-jupyter labextension link .
+jlpm
+jlpm build
+jupyter labextension install .
 ```
 
 To rebuild the package and the JupyterLab app:
 
 ```bash
-npm run build
+jlpm build
 jupyter lab build
 ```
 
-To run tests suite:
+To watch the files and build continuously:
 
 ```bash
-npm test
+jlpm watch           # leave this running...
+jupyter lab --watch  # ...in another terminal
+```
+
+To check and fix code style:
+
+```bash
+jlpm lint
+```
+
+To run test the suite:
+
+```bash
+jlpm test
 ```

py_src/jupyter_lsp/CONTRIBUTING.md

@@ -157,6 +157,15 @@ python scripts/utest.py
 
 ### Browser-based Acceptance Tests
 
+The browser tests will launch JupyterLab on a random port and exercise the
+Language Server features with [Robot Framework][] and [SeleniumLibrary][].
+
+[robot framework]: https://github.com/robotframework/robotframework
+[seleniumlibrary]: https://github.com/robotframework/seleniumlibrary
+
+First, ensure you've prepared JupyterLab for `jupyterlab-lsp`
+[development](../../README.md#development).
+
 Prepare the enviroment:
 
 ```bash
@@ -165,22 +174,20 @@ conda env update -n jupyterlab-lsp --file environment-atest.yml
 pip install -r requirements-atest.txt  # ... and install geckodriver, somehow
 ```
 
-> To use with `jupyterlab-lsp` in JupyterLab, ensure you've
->
-> ```
-> jlpm
-> jlpm build
-> jupyter labextension install .
-> ```
-
-````
-> in the root of this repo. See the [README](../../README.md#development) for more
-
 Run the tests:
 
 ```bash
 python scripts/atest.py
-````
+```
+
+The Robot Framework reports and screenshots will be in `atest/output`, with
+`<operating system>_<python version>.log.html` being the most interesting
+artifacts, e.g.
+
+```
+- linux_37.log.html
+- linux_37.report.html
+```
 
 ### Formatting