X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;ds=sidebyside;f=Nwiz;h=331906c988db21524b07f406233efb163a17f6f9;hb=cfbc94007190d2d53de46147fb008a04b1224648;hp=9c9e5acd91f2378da602278fa4052f659ee92b28;hpb=605cb06d0e9b8fa057c33791187210c0bdfd09d9;p=wiki.git
diff --git a/Nwiz b/Nwiz
index 9c9e5ac..331906c 100644
--- a/Nwiz
+++ b/Nwiz
@@ -1,15 +1,17 @@
-== nwiz ==
+== nwiz, the code editor for a more civilized era ==
=== What's this? ===
+** My goal is to use [[https://neovim.io/ | Neovim]] as a modern coding environment for C, C++, Rust, Python and other languages. **
+
+
{{nvim-completion.png | maxwidth=600}}
+
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"
which aim to be a complete IDE, but all of them had maturity and usability issues.
-My goal is using Neovim as a productive and unintrusive IDE for C, C++, Rust and Python.
-I curated a short list of well-maintained plugins that take advantage of Neovim's built-in
-IDE components:
+I curated a list of well-maintained plugins that take advantage of Neovim's built-in IDE components:
* Language Server Protocol, for semantic completion
* Treesitter, for semantic syntax highlighting
@@ -17,20 +19,30 @@ IDE components:
* Floating windows, for inline help and function parameter assistance
The plugin ecosystem is still maturing, but over time the amount of Lua scripting required
-to piece together a functional IDE seems to be going down. Ideally, you wouldn't have
+to piece together a fully 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 without becoming the 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
* Inline diagnostics and hints
+=== Requirements ===
+
+TODO: Minimum neovim version?
+
+TODO: Recommend a good terminal with undercurls, mouse support...
+
+TODO: Nerd fonts installation
+
+
=== Installation ===
To get started, download nwiz.lua to Neovim's plugin dir so it will be autoloaded at startup:
@@ -94,6 +106,9 @@ 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 ===