docs: rephrase the vale warnings that have a better wording

Words the alex and Microsoft styles flag where a plainer one reads as well:
disabled/special/invalid as a state, primitive, trap, hang, several, click,
first-person FAQ questions, hyphenated adverb pairs. Left as they are: Let's
Encrypt, quoted UI labels and phrases, the generated forge CLI reference, and
the middle-click gesture.

docs/README.md

@@ -13,7 +13,7 @@ declarations.
 
 - **Bringing a fresh swarm online?** → [`getting-started/setup.md`](getting-started/setup.md)
   (the hand steps after the first switch).
-- **What does the dashboard look like, and how do I use it?** →
+- **What does the dashboard look like, and how to use it?** →
   [`web-ui/`](web-ui/README.md) — the operator-facing starting point;
   its own sub-pages ([`shape`](web-ui/shape.md),
   [`dashboard`](web-ui/dashboard.md), [`agent`](web-ui/agent.md),
@@ -57,9 +57,9 @@ declarations.
 - **How do I give an agent a GitHub account (`gh` + `git push`)? how's
   the PAT injected?** → [`integrations/github.md`](integrations/github.md)
   (operator content up top; the `gh`/git-push + notification-poller
-  mechanics are in a collapsed "Implementation" section at the bottom).
+  mechanics are in a collapsed section on how it is implemented at the bottom).
 - **What's `/knowledge`? How does the swarm-wide knowledge repo sync,
-  and how do I contribute a document?** → [`integrations/knowledge.md`](integrations/knowledge.md).
+  and how to contribute a document?** → [`integrations/knowledge.md`](integrations/knowledge.md).
 - **What does `hivectl` do? Provisioning, gateway users, container
   shells?** → [`tools/hivectl.md`](tools/hivectl.md) (the curated guide);
   [`tools/hivectl-cli.md`](tools/hivectl-cli.md) for the exhaustive,
@@ -71,7 +71,7 @@ declarations.
   discovery work?** → [`networking/gateway.md`](networking/gateway.md).
 - **How does DNS resolution work in agent containers? What's the
   bridge network for?** → [`networking/network.md`](networking/network.md).
-- **How do I connect two hives into a swarm?** → [`swarm/`](swarm/README.md)
+- **How are two hives connected into a swarm?** → [`swarm/`](swarm/README.md)
   (peer hives, TLS trust).
 - **Where do agent snapshots go? How does the swarm's `btrfs receive`
   endpoint authenticate a pushing hive?** →
@@ -86,18 +86,18 @@ declarations.
   sealed?** → [`swarm/bao.md`](swarm/bao.md).
 - **How does an agent get a prompt at set times, and why doesn't it fire
   twice after downtime?** → [`swarm/schedules.md`](swarm/schedules.md).
-- **How do I set an agent's model or effort from the swarm, and what happens
+- **How to set an agent's model or effort from the swarm, and what happens
   to its own pick?** → [`swarm/inference.md`](swarm/inference.md).
 - **How will a PR get checked against its repo's own yes/no rules before
   a full review?** → [`swarm/review-classifier.md`](swarm/review-classifier.md)
   (planned, not implemented yet).
 - **Does an agent config PR build before it's merged?** →
   [`swarm/builder.md`](swarm/builder.md).
-- **How do I create an agent from a ready-made set of permissions and
+- **How to create an agent from a ready-made set of permissions and
   settings?** → [`swarm/archetypes.md`](swarm/archetypes.md).
 - **How long do CI runs take, per repo and PR, and where does the board get
   it?** → [`swarm/ci-metrics.md`](swarm/ci-metrics.md).
-- **How do I log an agent in to claude from the swarm UI, and why doesn't a
+- **How to log an agent in to claude from the swarm UI, and why doesn't a
   stale stored copy log it out again?** →
   [`swarm/claude-login.md`](swarm/claude-login.md).
 - **How does an agent get a todo when someone assigns it an issue, and lose it
@@ -111,7 +111,7 @@ declarations.
   queue sources, scheduler internals?** → [`scheduler/coordinator.md`](scheduler/coordinator.md).
 - **How does the CI runner work? How does it register?** →
   [`scheduler/ci.md`](scheduler/ci.md).
-- **How do I export Claude Code metrics (tokens, cost, tool calls) to
+- **How are Claude Code metrics (tokens, cost, tool calls) exported to
   Prometheus/Grafana?** → [`scheduler/observability.md`](scheduler/observability.md).
 
 ## Crate reference