simpler check and deps messages

rig/README.md

@@ -58,10 +58,13 @@ make docs      # serves on localhost, prints the URL
 They run before anything is installed, which matters because they are the
 instructions for everything else. No cluster and no toolchain required.
 
+Why the code is the way it is — the reasoning, measurements and gotchas — lives
+in [`docs/notes/`](docs/notes/), one file per script, so the code keeps short comments.
+
 ## Then
 
 ```bash
-make check         # report host and config problems; changes nothing
+make check         # is this machine ready? short; `make check all` for every detail
 make deps          # install the toolchain (add `core` on a managed machine)
 make cluster up    # cluster + registry + the profile's addons
 ```
@@ -72,14 +75,14 @@ cluster without going near docker.io. `make check` shows its port, among
 everything else:
 
 ```bash
-make check                  # ... registry  endpoint  localhost:<port>
+make check                  # ... registry    localhost:<port>  (running)
 docker build -t localhost:<port>/app:1 .
 docker push localhost:<port>/app:1
 kubectl --context kind-$(basename $PWD) run app --image=localhost:<port>/app:1
 ```
 
 The port block is derived from the directory name, so two copies of rig never
-collide — nothing to configure. `make check` lists it; `bash ctrl/ports.sh persist`
+collide — nothing to configure. `make check all` lists it; `bash ctrl/ports.sh persist`
 pins it into `ctrl/.env` if you want it fixed:
 
 ```bash