dev aware pkgs clarification

Author: mxcl

README.md

@@ -12,15 +12,16 @@ dev, across your team and in production.
 
 ## Getting Started
 
-Since `dev` v1.8.0 we integrate with `pkgm` (^0.11) and this is the
-recommended way to use `dev`.
+Since `dev` v1.8.0 we integrate with `pkgm` (^0.11) and this is the recommended
+way to use `dev`.
 
 > [!IMPORTANT]
 >
-> `dev` must be installed to `/usr/local/bin/dev` for this route to work:
+> Both `dev` and the packages you want to be `dev`-aware must be installed to
+> `/usr/local/` for this to work. (`dev` (but only `dev`) can be a `pkgm shim`).
 >
 > ```sh
-> sudo pkgm install dev  # use of `shim` is also fine
+> sudo pkgm install dev node@22
 > ```
 
 ```sh
@@ -68,7 +69,13 @@ just the terminal.
 
 ## `dev` via Shellcode
 
-Shellcode works _as well_ and is your preference. It has notable caveats with
+Shellcode is how `dev` used to work. We still support it. It has the advantage
+that none of your tool need be installed — so use is at your preference.
+
+<details>
+<summary>Shellcode usage…</summary>
+
+ It has notable caveats with
 regard to use in tools like editors. It also requires you to add shellcode to
 your `shell.rc` files and thus is more intrusive (depending on your outlook).
 
@@ -106,6 +113,8 @@ more shells.
 > If you like, preview the shellcode: `pkgx dev --shellcode`. This command only
 > outputs shellcode, it doesn’t modify any files or do anything else either.
 
+</details>
+
 ### Usage
 
 ```sh