vale fixes for install from source guide

Signed-off-by: Jared Watts <jbw976@gmail.com>

Author: jbw976

content/master/guides/install-from-source.md

@@ -81,7 +81,7 @@ export REGISTRY="your-registry.com/your-org"; \
 
 The build embeds `${VERSION}` into the Crossplane binary and uses it as the
 container image tag and Helm chart version. Nix's sandboxed builds only read
-from files tracked by git, so `${VERSION}` must be written into `flake.nix`
+from files tracked by git, so you must write `${VERSION}` into `flake.nix`
 before building:
 
 ```shell {copy-lines="all"}
@@ -105,8 +105,10 @@ platforms:
 nix build
 ```
 
-The first run downloads the build toolchain and takes a few minutes. Subsequent
+<!-- vale write-good.Weasel = NO -->
+The first run downloads the build toolchain and takes a few minutes. Later
 runs reuse the Nix store cache and complete in seconds.
+<!-- vale write-good.Weasel = YES -->
 
 The build output is under `./result/`:
 
@@ -116,8 +118,8 @@ The build output is under `./result/`:
 - `result/images/linux_<arch>/image.tar.gz` is the container image tarball for
   each supported Linux architecture.
 
-The build does not load images into your local Docker daemon. The image
-tarballs in `result/images/` are loaded automatically by the push step.
+The build doesn't load images into your local Docker daemon. The push step
+loads the image tarballs in `result/images/` automatically.
 
 ### Push the image to your registry
 
@@ -134,10 +136,10 @@ nix run .#push-images -- ${REGISTRY}/crossplane
 ```
 
 {{< hint "note" >}}
-If your host Docker is configured with a credential helper (for example
+If your host Docker uses a credential helper (for example
 Docker Desktop on macOS), the helper isn't available on the sandboxed
 `PATH` used by `nix run .#push-images`. Bypass the helper for the login
-and push by writing auth directly to a temporary Docker config:
+and push by writing auth directly to a temporary Docker configuration:
 
 ```shell
 export DOCKER_CONFIG=$(mktemp -d)
@@ -232,14 +234,14 @@ v2.0.0-yourtag
 
 ### Clean up the working tree
 
-The earlier `sed` step modified `flake.nix`, which is tracked by git. After all
+The earlier `sed` step modified `flake.nix`, a file that git tracks. After all
 build, push, and install steps are complete, revert the change to keep your
 working tree clean:
 
 ```shell {copy-lines="all"}
 git checkout flake.nix
 ```
 
-Reverting this file before the push or install steps complete causes Nix to
-re-evaluate the flake with `buildVersion = null`, which produces an
-auto-generated version that won't match the artifacts you already built.
+Reverting this file before completing the push or install steps causes Nix to
+rebuild the flake with `buildVersion = null`, which produces a different
+version that doesn't match the artifacts you already built.

utils/vale/styles/Crossplane/allowed-jargon.txt

@@ -114,6 +114,7 @@ syscall
 templated
 TLS
 tolerations
+toolchain
 TTL
 UI
 VM

utils/vale/styles/Crossplane/spelling-exceptions.txt

@@ -28,12 +28,14 @@ idempotency
 in-depth
 in-memory
 Job.
+language-specific
 least-privilege
 left-hand
 long-running
 Long-running
 low-risk
 low-traffic
+multi-arch
 multi-cluster
 multi-region
 Multi-step
@@ -51,6 +53,7 @@ out-of-sync
 Operation-level
 pattern-based
 Pattern-based
+per-architecture
 per-element
 performant
 per-object