linting, update advanced installing example versions, fix typos and formatting

Author: bollwyvl

docs/Installation.ipynb

@@ -15,21 +15,27 @@
     "\n",
     "Delivering LSP features to your JupyterLab **requires** three pieces:\n",
     "\n",
-    "- `jupyter_lsp`\n",
-    "  - runs in your `notebook` web application on your server\n",
-    "  - to run, you need:\n",
-    "    - `python >=3.5`\n",
-    "    - `notebook >=4.3`\n",
-    "- `jupyterlab-lsp`\n",
-    "  - runs in your browser\n",
-    "  - to install it, you need:\n",
-    "    - `nodejs >8`\n",
-    "    - `jupyterlab >=1.1,<2`\n",
-    "- one or more language servers\n",
-    "  - run on your server\n",
-    "  - some can be automatically [detected](./Language%20Servers.ipynb) if\n",
-    "    installed\n",
-    "  - others also need to be [configured](./Configuring.ipynb#language_servers)"
+    "#### `jupyter_lsp`\n",
+    "\n",
+    "- runs in your `notebook` web application on your server to handle requests from\n",
+    "  the browser to _language servers_\n",
+    "- to run, you need:\n",
+    "  - `python >=3.5`\n",
+    "  - `notebook >=4.3`\n",
+    "\n",
+    "#### `jupyterlab-lsp`\n",
+    "\n",
+    "- runs in your browser, as an extension to JupyterLab\n",
+    "- to install it, you need:\n",
+    "  - `nodejs >8`\n",
+    "  - `jupyterlab >=1.1,<2`\n",
+    "\n",
+    "#### Language Servers\n",
+    "\n",
+    "- run on your server,\n",
+    "  - probably in another language runtime than python\n",
+    "- some can be automatically [detected](./Language%20Servers.ipynb) if installed\n",
+    "- others also need to be [configured](./Configuring.ipynb#language_servers)"
    ]
   },
   {
@@ -49,11 +55,11 @@
     "#### conda (minimal python)\n",
     "\n",
     "```bash\n",
-    "conda create -c conda-forge -n lsp 'python >=3.7,<3.8' 'jupyterlab=1.2' 'nodejs=11' python-language-server\n",
+    "conda create -c conda-forge -n lsp 'python >=3.7,<3.8' 'jupyterlab=1.2' 'nodejs>8' python-language-server\n",
     "# Also consider: r-languageserver [*]\n",
     "source activate lsp\n",
-    "python -m pip install 'jupyter_lsp=0.7' --no-deps\n",
-    "jupyter labextension install '@krassowski/jupyterlab-lsp@0.7.1'\n",
+    "python -m pip install 'jupyter_lsp=0.8.0' --no-deps\n",
+    "jupyter labextension install '@krassowski/jupyterlab-lsp@0.8.0'\n",
     "```\n",
     "\n",
     "Then run\n",
@@ -91,9 +97,9 @@
     "    'python-language-server' \\\n",
     "    'r-languageserver' \\\n",
     "  && python3 -m pip install --no-cache-dir --no-deps \\\n",
-    "    'jupyter_lsp==0.7' \\\n",
+    "    'jupyter_lsp==0.8.0' \\\n",
     "  && jupyter labextension install --no-build \\\n",
-    "    '@krassowski/jupyterlab-lsp@0.7.1' \\\n",
+    "    '@krassowski/jupyterlab-lsp@0.8.0' \\\n",
     "  && jupyter lab build --dev-build=False --minimize=True \\\n",
     "  && conda clean --all -f -y \\\n",
     "  && rm -rf \\\n",
@@ -202,7 +208,7 @@
     "\n",
     "```bash\n",
     "pip install jupyter_lsp\n",
-    "jupyter labextension install @krassowitz/jupyterlab-lsp\n",
+    "jupyter labextension install @krassowski/jupyterlab-lsp\n",
     "```"
    ]
   },

docs/Releasing.ipynb

@@ -22,8 +22,8 @@
     "python scripts/integrity.py\n",
     "```\n",
     "\n",
-    "> TODO: create a `release.py` script\n",
-    "> [#88](https://github.com/krassowski/jupyterlab-lsp/issues/88)\n",
+    "- TODO: create a `release.py` script\n",
+    "  [#88](https://github.com/krassowski/jupyterlab-lsp/issues/88)\n",
     "\n",
     "The PyPI version must be updated in the following places:\n",
     "\n",

py_src/jupyter_lsp/specs/utils.py

@@ -45,7 +45,7 @@ def __call__(self, mgr: LanguageServerManagerAPI) -> KeyedLanguageServerSpecs:
             if cmd:
                 break
 
-        if not cmd and BUILDING_DOCS:   # pragma: no cover
+        if not cmd and BUILDING_DOCS:  # pragma: no cover
             cmd = self.cmd
 
         if not cmd:  # pragma: no cover