update language server docs for robot, pyright

Author: bollwyvl

docs/Language Servers.ipynb

@@ -135,8 +135,8 @@
    "source": [
     "### Notebook-optimized Language Servers\n",
     "\n",
-    "These servers have support for notebooks and file editors. The `pyls` and\n",
-    "`r-languageserver` are well-tested, while `jedi` and `Julia` servers are\n",
+    "These servers have support for notebooks and file editors. The `pylsp`, and\n",
+    "`r-languageserver`, and `robotframework_ls` implementatoons are well-tested, while `jedi` and `Julia` servers are\n",
     "experimental. If you choose to install multiple language servers for the same\n",
     "language, the one with the highest `priority` (which can be set in the _Advanced\n",
     "Settings Editor_) will be used."
@@ -158,10 +158,14 @@
     "    \"r-languageserver\",\n",
     "    \"julia-language-server\",\n",
     "    \"jedi-language-server\",\n",
+    "    \"robotframework_ls\",\n",
     "]\n",
-    "lang_server_table(\n",
-    "    {key: spec for key, spec in mgr.all_language_servers.items() if key in nb_langs}\n",
-    ")"
+    "lang_server_table({\n",
+    "    key: spec\n",
+    "    for key, spec\n",
+    "    in sorted(mgr.all_language_servers.items())\n",
+    "    if key in nb_langs\n",
+    "})"
    ]
   },
   {
@@ -203,21 +207,20 @@
    },
    "outputs": [],
    "source": [
-    "lang_server_table(\n",
-    "    {\n",
-    "        key: spec\n",
-    "        for key, spec in mgr.all_language_servers.items()\n",
-    "        if \"npm\" in spec[\"install\"]\n",
-    "    }\n",
-    ")"
+    "npm_specs = {\n",
+    "    key: spec\n",
+    "    for key, spec in sorted(mgr.all_language_servers.items()) \n",
+    "    if \"npm\" in spec[\"install\"]\n",
+    "}\n",
+    "lang_server_table(npm_specs)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "NodeJS is a prerequisite for installation of any of the above language servers;\n",
-    "you can get it with:\n",
+    "NodeJS (preferrably even-numbered an _Active_ or _Maintenance Long Term Support_ release) \n",
+    "is a prerequisite for installation of any of the above language servers; you can get it with:\n",
     "\n",
     "```bash\n",
     "conda install -c conda-forge nodejs\n",
@@ -242,19 +245,32 @@
     "`node_modules` in the directory where you launch `jupyter lab`.\n",
     "\n",
     "For example, to install all the servers which are tested as part of\n",
-    "`jupyterlab-lsp`:\n",
-    "\n",
-    "```bash\n",
-    "jlpm add --dev \\\n",
-    "    bash-language-server \\\n",
-    "    vscode-css-languageserver-bin \\\n",
-    "    dockerfile-language-server-nodejs \\\n",
-    "    vscode-html-languageserver-bin \\\n",
-    "    typescript-language-server \\\n",
-    "    vscode-json-languageserver-bin \\\n",
-    "    yaml-language-server\n",
+    "`jupyterlab-lsp`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "tags": [
+     "remove-input"
+    ]
+   },
+   "outputs": [],
+   "source": [
+    "IPython.display.Markdown(Template(\"\"\"```bash\n",
+    "jlpm add --dev {% for name, spec in specs.items() %} \\\\\n",
+    "    {{ spec[\"install\"][\"npm\"].split(\" \")[-1] }}{% endfor %}\n",
     "```\n",
-    "\n",
+    "\"\"\").render(\n",
+    "    specs=npm_specs\n",
+    "))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
     "This will create (or add to):\n",
     "\n",
     "- `package.json` (check this in!)\n",
@@ -369,9 +385,9 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.9"
+   "version": "3.10.0"
   }
  },
  "nbformat": 4,
  "nbformat_minor": 4
-}
+}