README tweaking is my hobby

Author: mxcl

README.md

@@ -9,14 +9,19 @@ packages you need for different projects as you navigate in your shell.
 pkgx dev integrate
 ```
 
-> [!NOTE]
+We support macOS & Linux, **Bash** & **Zsh**. PRs are very welcome for more
+shells.
+
+> [!IMPORTANT]
 >
 > `pkgx` is a required dependency.
 >
 > ```sh
 > brew install pkgxdev/made/pkgx || sh <(curl https://pkgx.sh)
 > ```
 
+> [!NOTE]
+>
 > `pkgx dev integrate` looks for and edits known `shell.rc` files adding one
 > line:
 >
@@ -29,26 +34,8 @@ pkgx dev integrate
 > ```sh
 > pkgx dev integrate --dry-run
 > ```
-
-> We support **Bash** and **Zsh**. We would love to support more shells. PRs
-> very welcome.
-
-> [!TIP]
-> If you like, preview the shellcode: `pkgx dev --shellcode`.
-
-> [!TIP]
->
-> ### Try Before You `vi`
->
-> Modifying your `shell.rc` can be… _intimidating_. If you just want to
-> temporarily try `dev` out before you `:wq`—we got you:
->
-> ```sh
-> $ cd my-project
-> $ eval "$(pkgx dev)"
-> ```
 >
-> The devenv will only exist for the duration of your shell session.
+> If you like, preview the shellcode: `pkgx dev --shellcode`.
 
 ## Usage
 
@@ -60,6 +47,7 @@ package.json
 
 my-project $ dev
 +nodejs.org
+# ^^ installs node to ~/.pkgx/nodejs.org/v22.12.0 if not already installed
 
 my-project $ node --version
 v22.12.0
@@ -74,6 +62,20 @@ $ node
 command not found: node
 ```
 
+> [!TIP]
+>
+> ### Try Before You `vi`
+>
+> Modifying your `shell.rc` can be… _intimidating_. If you just want to
+> temporarily try `dev` out before you `:wq`—we got you:
+>
+> ```sh
+> $ cd my-project
+> $ eval "$(pkgx dev)"
+> ```
+>
+> The devenv will only exist for the duration of your shell session.
+
 ## How Packages are Determined
 
 - We look at the files you have and figure out the packages you need.
@@ -126,6 +128,13 @@ You can add your own environment variables if you like:
 #   MY_VAR: my-value
 ```
 
+> [!CAUTION]
+>
+> The assignment of these variables are run through the shell, so you can do
+> stuff like `$(pwd)` if you like. Obviously, be careful with that—we don’t
+> sanitize the input. We will accept a PR to escape this by default or something
+> ∵ we agree this is maybe a bit insane.
+
 ## GitHub Actions
 
 ```yaml
@@ -137,4 +146,6 @@ your terminal.
 
 ## Contributing
 
+We use `deno`, so either install that or—you know—type `dev`.
+
 Edit [./src/sniff.ts](src/sniff.ts) to add new dev types.