X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=Nwiz;h=6681ef9e2c73d6259ac7d0d87ddf39d5c8431130;hb=f2cd6408f2cadadc3bae56f5aa59952bff01b014;hp=2374a6cd91ab7d5d2d6b651dafdeec4928e1a52b;hpb=5a2bfdcaaef0685bd2c0843a0774084fccb2c6f3;p=wiki.git

diff --git a/Nwiz b/Nwiz
index 2374a6c..6681ef9 100644
--- a/Nwiz
+++ b/Nwiz
@@ -1,7 +1,9 @@
-== nwiz.lua - A Neovim config for a more civilized age ==
+== nwiz, the code editor for a more civilized era ==
 
 === What's this? ===
 
+<div style="float: right">{{nvim-completion.png | maxwidth=600}}</div>
+
 Neovim has no shortage of powerful plugins for programmers, but it's a fast moving ecosystem.
 Picking the right combination of plugins and configuring them as an integrated development
 environment is still far from trivial. I also reviewed a number of GUIs and "super plugins"
@@ -20,11 +22,12 @@ The plugin ecosystem is still maturing, but over time the amount of Lua scriptin
 to piece together a functional IDE seems to be going down. Ideally, you wouldn't have
 to learn Lua to edit your Neovim config.
 
-** I want a programmer's editor, not become an editor's programmer! **
+** I want a programmer's editor, not to become an editor's programmer! **
+
 
 === Features ===
 
- * Quick open files
+ * Quickly open files with fuzzy search
  * Semantic completion
    * Configures language servers for C/C++, Rust, Python
    * Adding more languages made easy by lspconfig
@@ -61,14 +64,44 @@ Any time you edit the list of plugins, run ##:PackerSync## to install, uninstall
 
 === Language Servers ===
 
-TODO
+Neovim 0.7 comes with a built-in LSP client. The official [[https://github.com/neovim/nvim-lspconfig | nvim-lspconfig]]
+plugin abstracts the details of spawning the correct Language Server for a multitude of filetypes.
+
+Download and installation of language servers can be managed automatically by
+[[https://github.com/williamboman/nvim-lsp-installer | nvim-lsp-installer]], but I find that it's
+simpler (and much safer!) to install the already packaged ones from Linux distro. This also ensures
+that they stay aligned with the system toolchain.
+
+ * Rust: rust-analyzer
+ * C++: clangd
+ * Python: python-lsp-server (which uses mypy, pylint, autopep8...)
 
 === Treesitter syntax parsers ===
 
 Install the ones you like from this list: https://github.com/nvim-treesitter/nvim-treesitter#supported-languages
 
-For instance:
+For instance, I installed these:
 
 {{{
-:TSInstall c cpp rust lua python bash vim
-}}}
\ No newline at end of file
+:TSInstall cpp rust lua python bash vim
+}}}
+
+You can refresh your parsers at any time with ##:TSUpdate##
+
+=== Semantic completion ===
+
+Just press TAB!
+
+TODO: docs for [[https://github.com/hrsh7th/nvim-cmp#readme | cmp-nvim]]
+
+
+=== Finding and opening files ===
+
+{{nvim-telescope.png | maxwidth=400}}
+
+
+TODO: docs for [[https://github.com/nvim-telescope/telescope.nvim | telescope.nvim]]
+
+=== Realtime diagnostics and hints ===
+
+TODO: document