doc updates

* recommend upstream nim extension for vscode
* move editor integrations to manual
* better install isntructions

Author: arnetheduck

README.md

@@ -37,29 +37,21 @@ More information about features and style available from the [documentation](htt
 
 ## Installation
 
-Download binaries from the [releases page](https://github.com/arnetheduck/nph/releases/tag/latest).
+Binaries are available from the [releases page](https://github.com/arnetheduck/nph/releases/tag/latest) on Github.
 
-`nph` can be also compiled or installed using `nimble` version `v0.14.2`+:
+`nph` can be also compiled or installed using `nimble` v0.16.4+:
 
 ```sh
-nimble -l setup
+# Install globally
+nimble install nph
+
+# Alternatively, build in source folder:
+nimble setup -l
 nimble build
 ```
 
+See the [installation instructions](https://arnetheduck.github.io/nph/installation.html) in the manual for more details.
+
 ## Editor integration
 
-* [VSCode](https://marketplace.visualstudio.com/items?itemName=arnetheduck.vscode-nph) (`ext install arnetheduck.vscode-nph`)
-* [NeoVim](https://github.com/sbdchd/neoformat) - Install **neoformat** in your neovim setup then add the nim formating option with **nph** with this option in init.vim `let g:neoformat_enabled_nim = ['nph']`
-* [Zed Editor](https://github.com/foxoman/zed-nim) - Use this in your editor settings 
-```
-"languages": {
-    "Nim": {
-      "formatter": {
-        "external": {
-          "command": "nph",
-          "arguments": ["-"]
-        }
-      }
-    }
-  }
-```
+Editor integrations are described [in the manual](https://arnetheduck.github.io/nph/installation.html#editor-integration).

docs/src/installation.md

@@ -6,22 +6,45 @@ Download binaries from the [releases page](https://github.com/arnetheduck/nph/re
 
 ## Install via nimble
 
-`nph` can be also compiled or installed using `nimble` version `v0.14.2`+:
+`nph` can be compiled or installed using `nimble` v0.16.4+:
 
 ```sh
-nimble -l setup
+# Install globally
+nimble install nph
+
+# Alternatively, clone and build:
+git clone https://github.com/arnetheduck/nph.git
+cd nph
+nimble setup -l
 nimble build
 ```
 
-```admonish note "Nim version requirement"
+```admonish note "Nim version"
 `nph` requires an specific version of `nim` during the build process since it
 reuses parts of the compiler whose API frequently changes - this may lead to
-`nim` itself being built as part of the installation process
+`nim` itself being built as part of the installation process!
 ```
 
 For bonus points, replace `nimpretty` with a symlink to `nph` - similar
 command line options are supported ;)
 
 ## Editor integration
 
-* [VSCode](https://marketplace.visualstudio.com/items?itemName=arnetheduck.vscode-nph) (`ext install arnetheduck.vscode-nph`)
+* [VSCode](https://marketplace.visualstudio.com/items?itemName=NimLang.nimlang) (`ext install NimLang.nimlang`) extension via [nimlangserver](https://github.com/nim-lang/langserver/) that supports `nph` out of the box
+* [NeoVim](https://github.com/sbdchd/neoformat) - Install **neoformat** in your neovim setup then add the nim formating option with **nph** with this option in init.vim `let g:neoformat_enabled_nim = ['nph']`
+* [Zed Editor](https://github.com/foxoman/zed-nim) - Use this in your editor settings
+```
+"languages": {
+    "Nim": {
+      "formatter": {
+        "external": {
+          "command": "nph",
+          "arguments": ["-"]
+        }
+      }
+    }
+  }
+```
+* [vscode-nph](https://marketplace.visualstudio.com/items?itemName=arnetheduck.vscode-nph) (`ext install arnetheduck.vscode-nph`) for a formatting-only option for the official Nim extension.
+
+

vscode-nph/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 0.0.5
+
+- Note that upstream now supports `nph`
+
 ## 0.0.4
 
 - Register formatter for '.nims' and '.nimble'

vscode-nph/README.md

@@ -2,6 +2,8 @@
 
 Format [Nim](https://nim-lang.org) code using [`nph`](https://github.com/arnetheduck/nph).
 
+Full-featured `Nim` support including formatting via `nph` is available from the [official Nim extension](https://marketplace.visualstudio.com/items?itemName=NimLang.nimlang) - if you're using it, `vscode-nph` is no longer needed.
+
 ## Features
 
 Enables formatting of Nim code via `Format document` from the command palette as well as format-on-save if enabled in settings.

vscode-nph/package.json

@@ -2,7 +2,7 @@
   "name": "vscode-nph",
   "displayName": "nph - Nim code formatter",
   "description": "Opinionated code formatter for Nim",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "publisher": "arnetheduck",
   "engines": {
     "vscode": "^1.30.0"