diff --git a/404.html b/404.html
index d1a3275..42daa40 100644
--- a/404.html
+++ b/404.html
@@ -40,7 +40,7 @@
     <div class="wrap cover-grid">
       <div>
         <h1>Nothing built here yet.</h1>
-        <p class="lead">There's no page at this address. All the mods are one click away, or go straight to a mod's own site.</p>
+        <p class="lead">There's no page at this address. Go back to the mods, or straight to a mod's own site.</p>
         <p><a class="btn" href="/">Back to the mods</a></p>
       </div>
       <nav class="needs" aria-label="The mods' own sites">
diff --git a/CLAUDE.md b/CLAUDE.md
index c74bde5..772c5ac 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -19,6 +19,24 @@ main).
 - The hub has no shared `release.js`; `assets/site.js` is hub-only. If you change or add a selector in it, update the
   stub DOM in `scripts/test-site.mjs` too (the stub throws on any selector it doesn't know).
 
+## Writing README and website text
+
+Kyler, 2026-09-24: "simplicity and elegance is effective and desirable." Every change to the README, the website
+text and the player docs follows these rules.
+
+- **Write for a Timberborn player** who wants to download, install and use the mod. Developer detail goes in
+  `DEVELOPING.md`; link to it rather than repeating it.
+- **Short.** One idea per sentence, most under about 20 words. A paragraph or FAQ answer is one to three sentences,
+  a troubleshooting answer a few numbered steps.
+- **Lead with the action.** Menu paths as arrow chains; on-screen labels in bold, exactly as in game.
+- **Say each thing once**, where a player would look for it; link to it elsewhere.
+- **Plain words.** No internals (class names, ids, formats) unless the player needs them to act.
+- **Cut** filler, repeated caveats, edge cases a player won't meet, and history ("since …", "no longer", older
+  builds). Describe the mod as it is now.
+- **Check every fact against the code** before writing it; changelogs lag.
+- **Keep, briefly:** credits, the unofficial line, the status, and safety facts.
+- **Reread as a new player before publishing.** Every step works as written, and nothing is said twice.
+
 ## Website
 
 - **Where:** the repo root: `index.html` (opening with the need index, three walnut boards of mods, install, footer),
@@ -104,6 +122,7 @@ main).
 
 ### Content rules
 
+- Every word follows *Writing README and website text* above.
 - Describe each mod as it is now. No "New in <version>", "added in …" or version history; that belongs in each mod's
   own release notes.
 - Each card's status line and caution wording match that mod's README exactly in substance (read it with
@@ -120,7 +139,7 @@ main).
 
 A new release alone needs **no** edit: the button, size, date, pill and "Newer preview" link update themselves. Edit
 the hub when a mod's features, status, requirements or caution change, when a mod is added, or when a mod's site
-changes its look.
+changes its look. Write every change by *Writing README and website text* above.
 1. Read the mod: `gh release list -R timbermods/<Repo> -L 5`, `gh release view <tag> -R timbermods/<Repo>`, its README
    (command above) and its site. List what changed for players.
 2. Update every place the hub states that fact:
diff --git a/DEVELOPING.md b/DEVELOPING.md
new file mode 100644
index 0000000..6e7eb60
--- /dev/null
+++ b/DEVELOPING.md
@@ -0,0 +1,78 @@
+# Developing the Timbermods site
+
+A static page with no build step and no dependencies. The maintainer rules (what never to edit, the markup hooks,
+the checklist for a changed mod) are in [CLAUDE.md](CLAUDE.md). The look is in [DESIGN.md](DESIGN.md).
+
+## Preview
+
+```bash
+node scripts/serve.mjs
+```
+
+Then open <http://127.0.0.1:8765/>. A missing path gets a plain 404, so open `/404.html` directly.
+
+## Publishing
+
+GitHub Pages builds from `main`, folder `/ (root)`. Merging to `main` publishes in about a minute. Every path is
+relative, except in `404.html`: Pages serves it at any missing address, so it uses root paths.
+
+## How "Download latest" works
+
+The buttons never hard-code a version. Each mod's `<article class="card">` carries `data-repo` and `data-asset`, a
+regex that picks the mod ZIP from a release's assets. In the browser, `assets/site.js`:
+
+1. paints at once from `data/releases.json`, the release snapshot;
+2. then checks the GitHub API live (two requests per mod, cached 30 minutes) and updates the button;
+3. if both fail, leaves the button as a plain link to the repo's Releases page.
+
+It offers the release GitHub marks as **Latest**, however many pre-releases follow it. A repo with only pre-releases
+gets its newest one, marked **Preview**. A pre-release published after the offered release adds a "Newer preview"
+link under the button.
+
+The pill says **Stable** unless the mod has a caution. Then it shows the `data-maturity` label (such as **Beta**), so
+the two never disagree.
+
+## The release snapshot
+
+`.github/workflows/refresh-releases.yml` runs `node scripts/update-releases.mjs` every hour (GitHub often runs it
+only every few hours; it can also be started from the Actions tab). It commits `data/releases.json` to `main`, so
+never edit that file by hand.
+
+The script keeps each repo's newest 12 releases and, under `latest`, GitHub's Latest release (`null` when there is
+none). It rewrites the file, and its `generated` time, only when the data changed. The footer reads "Release data last
+changed <date>". To run it yourself, set `GITHUB_TOKEN` to avoid rate limits.
+
+## Tests
+
+```bash
+node scripts/test-site.mjs
+```
+
+Every check must pass. They run offline: `assets/site.js` against a stub page and a fake GitHub API, and
+`update-releases.mjs` in a scratch folder against the same fake API. `.github/workflows/tests.yml` runs them on every
+pull request and every push to `main`.
+
+## Adding or changing a mod
+
+Copy an existing mod's `<article class="card">` in `index.html`. Set its `--c` accent colour, `data-repo`,
+`data-asset`, links and text. The snapshot script finds the new repo by itself. Add the mod to the need index,
+`404.html` and the README too; the full checklist is *Update the website* in [CLAUDE.md](CLAUDE.md).
+
+A mod with a caution (`<p class="caution">Beta: …</p>`) also needs `data-maturity` on its `<article>`, set to the
+caution's label (`data-maturity="Beta"`). When the mod is ready, remove both. The tests check that they match.
+
+## Files
+
+| Path | What it is |
+| --- | --- |
+| `index.html` | The page, with all eight mods |
+| `404.html` | The not-found page, with a link to each mod's site |
+| `assets/style.css` | Styles: walnut boards on birch by day, on a forest floor at night |
+| `assets/site.js` | The download buttons and the theme toggle |
+| `assets/fonts/` | Anybody, self-hosted (SIL Open Font License, `OFL-Anybody.txt`) |
+| `assets/img/` | The opening valley by day and at dusk (`make_valley.py`), the birch, forest-floor and walnut textures (`make_textures.py`), and the social preview `og.png` |
+| `assets/img/cards/` | Each mod's picture, a 960×600 capture from its own site |
+| `data/releases.json` | The release snapshot (generated) |
+| `scripts/` | `serve.mjs` (preview), `test-site.mjs` (tests), `update-releases.mjs` (snapshot) |
+| `scripts/card-art.py` | Recaptures the mods' pictures from their live sites: `python scripts/card-art.py [id ...]` (Playwright, Pillow, installed Microsoft Edge) |
+| `.github/workflows/` | The hourly snapshot refresh (`refresh-releases.yml`) and the tests (`tests.yml`) |
diff --git a/PRODUCT.md b/PRODUCT.md
index 6d68fcd..eeef2ef 100644
--- a/PRODUCT.md
+++ b/PRODUCT.md
@@ -52,7 +52,7 @@ the card `id`, its accent `--c` (taken from that mod's own site), its category p
    - Co-op with fewer crashes and desyncs: an independent fork of BeaverBuddies with Steam friend invites, a connection
      panel, teammate cursors and desync fixes.
    - **Feature-complete**: game-update and bug-fix releases only; new features go into Timber Together. GitHub's Latest.
-   - Its status line follows its README (the newest release is fixes only and hasn't been played yet). GPL-3.0.
+   - Its status line follows its README (the newest release has been played and works). GPL-3.0.
 2. **Timber Together** (`timber-together`, `#1a6a77`, Multiplayer; Harmony, Mod Settings;
    `data-maturity="Beta"` with a Beta caution).
    - Tagline *Build apart. Thrive together.* A colony each on one map; the colonies' roads never join, and they trade only at Trading Posts. Or
@@ -173,7 +173,8 @@ this file. Terms to use: Trading Post (capitalized); Timber Together has no land
 - **Words players use:** never "card", "binder", "pocket" or "sleeve" in anything a visitor reads; say "mod", or
   write the sentence without it. (The `.card` class name stays in the code: the tests and `site.js` need it.)
 - **Voice:** fellow players sharing mods they find useful. Plain, exact, friendly; say what each mod does and what it
-  needs. Never hype, never "the best", no superlatives the READMEs don't support.
+  needs. Never hype, never "the best", no superlatives the READMEs don't support. Short and plain: one idea per
+  sentence, each thing said once, no internals and no history (see CLAUDE.md, *Writing README and website text*).
 - **Unofficial:** community mods, not affiliated with or endorsed by Mechanistry. The footer says so and credits
   BeaverBuddies by thomaswp and contributors ("the multiplayer design is theirs") for the two BeaverBuddies mods. Keep
   both.
diff --git a/README.md b/README.md
index 92db3cf..bf89498 100644
--- a/README.md
+++ b/README.md
@@ -1,66 +1,27 @@
-# Timberborn Mods catalog
+# Timbermods
 
-A static, no-build catalog site for the Timberborn mods: BeaverBuddies Stability Fork, Timber Together, MixedStorage, Persistent Work Areas, Optimized Local Housing, Late Game Performance, The Tipsy Tail and Hungry Pathing. Each card links to the mod's own site and has a **Download latest** button.
+Every Timbermods mod for Timberborn on one page: **<https://timbermods.github.io/>**. Each mod has a **Download
+latest** button for its current release and a link to its own site.
 
-## Preview locally
+## The mods
 
-```bash
-node scripts/serve.mjs
-```
+- [BeaverBuddies Stability Fork](https://timbermods.github.io/BeaverBuddies-Stability-Fork/): co-op in one shared colony
+- [Timber Together](https://timbermods.github.io/TimberTogether/): co-op with a colony for each player
+- [Late Game Performance](https://timbermods.github.io/LateGamePerformance/): fewer lag spikes in big colonies
+- [Optimized Local Housing](https://timbermods.github.io/OptimizedLocalHousing/): shorter walks to work
+- [Hungry Pathing](https://timbermods.github.io/HungryPathing/): working beavers eat before the hunger penalty
+- [MixedStorage](https://timbermods.github.io/MixedStorage/): several goods in one warehouse
+- [Persistent Work Areas](https://timbermods.github.io/PersistentWorkAreas/): working-area outlines that stay on screen
+- [The Tipsy Tail](https://timbermods.github.io/timberborn-tipsy-tail/): a swim-up pool bar
 
-Then open <http://127.0.0.1:8765/>.
+Every mod installs the same way: see [Installing any of these](https://timbermods.github.io/#install).
 
-## Deploy to GitHub Pages
-
-1. Create a repo (the name `timbermods.github.io` gives you `https://timbermods.github.io/`), and push this folder to it.
-2. **Settings → Pages → Build and deployment**: deploy from branch `main`, folder `/ (root)`.
-
-All paths are relative, so it also works from a project repo (`.../some-repo/`).
-
-## How "Download latest" works
-
-The mods release often, so the buttons never hard-code a version. Each card has `data-repo` and `data-asset` (a regex that picks the mod ZIP from the release's assets). In the browser, `assets/site.js`:
-
-1. paints immediately from `data/releases.json`, a snapshot kept fresh by `.github/workflows/refresh-releases.yml` (scheduled hourly, though GitHub often runs it only every few hours; or run it from the Actions tab);
-2. then checks the GitHub API live (two requests per mod, cached 30 minutes) and updates the button;
-3. if both fail, the button is still a plain link to the repo's Releases page.
-
-Which release it offers: the one GitHub marks as **Latest** (the newest release that isn't a draft or a pre-release), however many pre-releases came after it. If a repo only has pre-releases it offers the newest of those and marks the card **Preview**. If the newest listed release is a pre-release published after the offered one, a small "Newer preview" link to it appears under the button. The main rule (GitHub's Latest, else the newest pre-release) is the one the shared `release.js` on most of the mods' own sites follows; the two differ in edge cases, such as a Latest release without a mod ZIP.
-
-The pill says **Stable** for a stable release, unless the card has a caution: then it shows the card's `data-maturity` (such as **Beta** or **Preview**), so it never contradicts the caution.
-
-Refresh the snapshot by hand: `node scripts/update-releases.mjs` (set `GITHUB_TOKEN` to avoid rate limits). For each repo it stores the newest 12 releases and, under `latest`, GitHub's Latest release (`null` when there is none). It rewrites the file, and its `generated` time, only when that data changed, so the footer reads "Release data last changed <date>"; after a live check of every card it says so instead.
-
-## Tests
-
-```bash
-node scripts/test-site.mjs
-```
-
-Offline checks with no dependencies: `assets/site.js` runs against a stub page and a fake GitHub API, and `scripts/update-releases.mjs` runs in a scratch folder against the same fake API. `.github/workflows/tests.yml` runs them on every push to `main` and every pull request.
-
-## Adding or changing a mod
-
-Copy an existing `<article class="card">` in `index.html`, then update its `--c` accent color, `data-repo`, `data-asset`, links and text. Running `scripts/update-releases.mjs` picks up the new repo automatically.
-
-A card with a caution (`<p class="caution">Beta: …</p>`) also needs `data-maturity` on its `<article>`, set to the caution's label (`data-maturity="Beta"`). When the mod is ready, remove both, and the pill says Stable. `scripts/test-site.mjs` checks that the two match.
-
-## Files
-
-| Path | Purpose |
-| --- | --- |
-| `index.html` | The page and all eight cards |
-| `404.html` | The not-found page, with a link to each mod's site |
-| `assets/style.css` | Styling: walnut boards on birch by day, on a forest floor at night; light and dark themes |
-| `assets/fonts/` | Anybody, self-hosted (SIL Open Font License, `OFL-Anybody.txt`) |
-| `assets/site.js` | Download buttons and theme toggle |
-| `assets/img/cards/` | Each mod's picture, a capture from that mod's own site (960×600) |
-| `assets/img/` | The opening valley by day and at dusk (`make_valley.py` draws them), birch, forest-floor and walnut textures (`make_textures.py`), and the social preview `og.png` |
-| `data/releases.json` | Release snapshot (generated) |
-| `scripts/` | `update-releases.mjs` (snapshot), `serve.mjs` (local preview), `test-site.mjs` (tests) |
-| `scripts/card-art.py` | Recaptures card art from each mod's live site: `python scripts/card-art.py [card-id ...]` (Playwright, Pillow, installed Edge) |
-| `.github/workflows/` | Hourly snapshot refresh (`refresh-releases.yml`) and the tests (`tests.yml`) |
+Working on the site itself? See [DEVELOPING.md](DEVELOPING.md).
 
 ## License
 
-MIT. See [LICENSE](LICENSE). Timberborn, its name and its artwork belong to Mechanistry and are not covered by this license; the card art in `assets/img/cards/` comes from each mod's own site, and some of it shows the game.
+MIT. See [LICENSE](LICENSE). Timberborn, its name and its artwork belong to Mechanistry and are not covered. Each
+mod's picture comes from that mod's own site, and some show the game.
+
+Unofficial, fan-made mods for Timberborn. Not affiliated with or endorsed by Mechanistry. BeaverBuddies Stability Fork
+and Timber Together build on [BeaverBuddies](https://github.com/thomaswp/BeaverBuddies) by thomaswp and contributors.
diff --git a/index.html b/index.html
index 4e54c8a..80a66a0 100644
--- a/index.html
+++ b/index.html
@@ -73,7 +73,7 @@ <h2>Find one by what you need</h2>
       <div class="wrap">
       <h2 id="mods-title" class="sr-only">The mods</h2>
       <section class="page" aria-labelledby="page-play">
-        <div class="page-head"><h2 id="page-play">Play together</h2><p>Co-op through BeaverBuddies. Install one BeaverBuddies at a time: the Stability Fork is one shared colony and is finished; Timber Together is built on it and adds a colony for each player.</p></div>
+        <div class="page-head"><h2 id="page-play">Play together</h2><p>Two co-op mods based on BeaverBuddies. Timber Together is built on the Stability Fork.</p></div>
         <div class="pockets">
         <div class="sleeve"><article class="card" id="beaverbuddies-stability-fork" style="--c:#b8322a"
                  data-repo="timbermods/BeaverBuddies-Stability-Fork" data-asset="^BeaverBuddies-Stability-Fork-[\d.]+\.zip$">
@@ -82,9 +82,9 @@ <h2 id="mods-title" class="sr-only">The mods</h2>
             <div class="meta"><span class="pill tag">Multiplayer</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/BeaverBuddies-Stability-Fork/">BeaverBuddies Stability Fork</a></h3>
             <p class="tagline">Co-op with fewer crashes and desyncs.</p>
-            <p class="blurb">An independent fork of BeaverBuddies for one shared colony, with Steam friend invites, a connection panel, teammate cursors and fixes for desyncs, crashes and reconnects. Feature-complete: it gets fixes and game updates, and new features go into Timber Together.</p>
-            <ul class="facts"><li>Invite Steam friends from Steam's overlay, no port forwarding</li><li>A connection panel with ping, sync state and chat</li><li>Refuses a mismatched build before it can desync</li></ul>
-            <p class="status-line">The newest release is fixes only and hasn't been played yet; the one before it was.</p>
+            <p class="blurb">Build one colony together in real time, in an independent fork of BeaverBuddies. It is feature-complete: it gets fixes and game updates, and new features go into Timber Together.</p>
+            <ul class="facts"><li>Invite Steam friends from Steam's overlay, no port forwarding</li><li>A connection panel with pings, sync state and chat</li><li>Refuses a different build before it can desync</li></ul>
+            <p class="status-line">The newest release has been played and works.</p>
             <p class="req"><span>Requires</span> Harmony, Mod Settings</p>
             <div class="dl">
               <a class="btn" data-download href="https://github.com/timbermods/BeaverBuddies-Stability-Fork/releases" rel="noopener"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3v12m0 0-4.5-4.5M12 15l4.5-4.5M4 20h16"/></svg><span class="btn-label">Download latest</span><span class="btn-size" data-size></span></a>
@@ -100,9 +100,9 @@ <h3><a href="https://timbermods.github.io/BeaverBuddies-Stability-Fork/">BeaverB
             <div class="meta"><span class="pill tag">Multiplayer</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/TimberTogether/">Timber Together</a></h3>
             <p class="tagline">Build apart. Thrive together.</p>
-            <p class="blurb">Built on BeaverBuddies by thomaswp, through the Stability Fork. Each player runs a colony of their own, with its own beavers, stock, science and working hours, on one shared map. The colonies' roads never join: they trade only at Trading Posts. Or share one colony, as in the fork.</p>
-            <ul class="facts"><li>A waiting room before a new game: invite, ready up, start together</li><li>Trading Posts exchange goods and beavers between colonies</li><li>Folktails and Iron Teeth can play in one game</li></ul>
-            <p class="caution"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3 2 21h20L12 3Zm0 6v6m0 3v.5"/></svg>Beta: the release candidate. Founding, building, Trading Posts and the waiting room were played; starting from the waiting room, mixed factions and the late game haven't been yet. Use a copy of a save.</p>
+            <p class="blurb">Co-op where every player runs their own colony on one shared map, with their own beavers, stock, science and working hours. The colonies meet only at Trading Posts.</p>
+            <ul class="facts"><li>Games start in a Co-op Game room: invite, ready up, start together</li><li>Trading Posts exchange goods and beavers between colonies</li><li>Folktails and Iron Teeth can play in one game</li></ul>
+            <p class="caution"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3 2 21h20L12 3Zm0 6v6m0 3v.5"/></svg>Beta: the release candidate. Founding, two colonies building side by side, Trading Posts and joining the Co-op Game room were played. Starting a game from that room, mixed factions and the late game haven't been yet. Play on a copy of your save.</p>
             <p class="req"><span>Requires</span> Harmony, Mod Settings</p>
             <div class="dl">
               <a class="btn" data-download href="https://github.com/timbermods/TimberTogether/releases" rel="noopener"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3v12m0 0-4.5-4.5M12 15l4.5-4.5M4 20h16"/></svg><span class="btn-label">Download latest</span><span class="btn-size" data-size></span></a>
@@ -115,14 +115,14 @@ <h3><a href="https://timbermods.github.io/TimberTogether/">Timber Together</a></
           <h3>Which one? One BeaverBuddies at a time</h3>
           <dl>
             <div style="--c:#b8322a"><dt>Stability Fork</dt><dd>Everyone builds one colony together.</dd></div>
-            <div style="--c:#1a6a77"><dt>Timber Together</dt><dd>Each player runs a colony of their own on the shared map, or everyone shares one colony, as in the fork.</dd></div>
+            <div style="--c:#1a6a77"><dt>Timber Together</dt><dd>A colony each on one map, or one shared colony, as in the fork.</dd></div>
           </dl>
-          <p>Install only one of the two. Every player in the game installs the same one.</p>
+          <p>Every player in the game installs the same one.</p>
         </div></div>
         </div>
       </section>
       <section class="page" aria-labelledby="page-big">
-        <div class="page-head"><h2 id="page-big">Big colonies</h2><p>For colonies that have grown large enough to hitch, walk too far or work hungry.</p></div>
+        <div class="page-head"><h2 id="page-big">Big colonies</h2><p>For colonies big enough to hitch, walk too far or work hungry.</p></div>
         <div class="pockets">
         <div class="sleeve"><article class="card" id="late-game-performance" style="--c:#5b3fd0"
                  data-repo="timbermods/LateGamePerformance" data-asset="^LateGamePerformance-[\d.]+\.zip$" data-maturity="Young mod">
@@ -131,8 +131,8 @@ <h3>Which one? One BeaverBuddies at a time</h3>
             <div class="meta"><span class="pill tag">Performance</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/LateGamePerformance/">Late Game Performance</a></h3>
             <p class="tagline">Fewer lag spikes in big colonies.</p>
-            <p class="blurb">Keeps answers the game has already worked out, moves heavy work such as route maps and save snapshots to other CPU cores, and skips lookups that can't change the result. Beavers decide exactly what they would anyway.</p>
-            <ul class="facts"><li>Built for BeaverBuddies co-op: the same code on every computer</li><li>Switches a feature off if anything unexpected happens</li><li>Timing lines in Player.log, to measure your own colony</li></ul>
+            <p class="blurb">Removes work the game repeats over and over in large colonies. It keeps answers already worked out, runs heavy work on other CPU cores and skips lookups that can't change the result. Beavers make the same choices, just sooner.</p>
+            <ul class="facts"><li>Built for BeaverBuddies co-op: the same code on every computer</li><li>A feature that hits an error switches off, and the game's own code runs</li><li>Timing lines in Player.log, to measure your own colony</li></ul>
             <p class="caution"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3 2 21h20L12 3Zm0 6v6m0 3v.5"/></svg>Young mod: played in a few sessions in one large colony. Try it on a copy of a save.</p>
             <p class="req"><span>Requires</span> Harmony 2.4.1+, Mod Settings</p>
             <div class="dl">
@@ -149,9 +149,9 @@ <h3><a href="https://timbermods.github.io/LateGamePerformance/">Late Game Perfor
             <div class="meta"><span class="pill tag">Housing</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/OptimizedLocalHousing/">Optimized Local Housing</a></h3>
             <p class="tagline">Shorter commutes, solved once a day.</p>
-            <p class="blurb">Once a day, moves adult beavers into the homes that give the whole colony the shortest total walk to work. Every home keeps its adults, and children never move.</p>
-            <ul class="facts"><li>Solves each district exactly, with the game's own route costs</li><li>Spread over many ticks, so there's no freeze</li><li>Turns itself off alongside Housing Optimize or Commute Balancer</li></ul>
-            <p class="status-line">Its first stable code was played; the newest changes are checked but not played yet.</p>
+            <p class="blurb">Once a day, moves adult beavers into the homes that give the whole colony the shortest total walk to work. Every home keeps the same number of adults, and children never move.</p>
+            <ul class="facts"><li>Solves each district exactly, with real route costs</li><li>Spread over many ticks, so there's no freeze</li><li>Turns itself off alongside Housing Optimize or Commute Balancer</li></ul>
+            <p class="status-line">Its first stable release was played; the newest changes pass automated tests but haven't been played yet.</p>
             <p class="req"><span>Requires</span> Nothing extra</p>
             <div class="dl">
               <a class="btn" data-download href="https://github.com/timbermods/OptimizedLocalHousing/releases" rel="noopener"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3v12m0 0-4.5-4.5M12 15l4.5-4.5M4 20h16"/></svg><span class="btn-label">Download latest</span><span class="btn-size" data-size></span></a>
@@ -167,8 +167,8 @@ <h3><a href="https://timbermods.github.io/OptimizedLocalHousing/">Optimized Loca
             <div class="meta"><span class="pill tag">Beaver needs</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/HungryPathing/">Hungry Pathing</a></h3>
             <p class="tagline">Fed before the whistle, not after.</p>
-            <p class="blurb">During working hours, beavers eat and drink before the hunger penalty, timed to their shift, at the closest stocked storage. Off duty nothing changes, and they don't eat more.</p>
-            <ul class="facts"><li>A three-hour buffer on Hunger and Thirst</li><li>Leaves a far job early enough to arrive with the buffer in hand</li><li>Nothing written to saves; built for co-op</li></ul>
+            <p class="blurb">Working beavers plan food and water around their shift instead of waiting for the hunger penalty. On the job, they eat at the closest stocked storage. Off duty nothing changes, and they don't eat more.</p>
+            <ul class="facts"><li>A three-hour buffer on Hunger and Thirst</li><li>Leaves a far job early enough to eat before the penalty</li><li>Nothing written to saves; built for co-op</li></ul>
             <p class="caution"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3 2 21h20L12 3Zm0 6v6m0 3v.5"/></svg>Beta: try it on a copy of your save first.</p>
             <p class="req"><span>Requires</span> Harmony 2.4.1+</p>
             <div class="dl">
@@ -190,8 +190,8 @@ <h3><a href="https://timbermods.github.io/HungryPathing/">Hungry Pathing</a></h3
             <div class="meta"><span class="pill tag">Storage</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/MixedStorage/">MixedStorage</a></h3>
             <p class="tagline">Several goods in one warehouse.</p>
-            <p class="blurb">Divide a warehouse or pile by percentage, say 50% carrots and 50% gears, with limits per good and a compact panel that shows exactly what is stored.</p>
-            <ul class="facts"><li>Split any warehouse or pile by percentage per good</li><li>Copy and paste an allocation between buildings</li><li>One download for single player and BeaverBuddies co-op</li></ul>
+            <p class="blurb">Divide a warehouse or pile by percentage, say 50% carrots and 50% gears. A compact panel shows exactly what is stored.</p>
+            <ul class="facts"><li>Folktails and Iron Teeth warehouses and piles</li><li>Copy and paste an allocation between buildings</li><li>One download for single player and Stability Fork co-op</li></ul>
             <p class="req"><span>Requires</span> Harmony 2.4.1+</p>
             <div class="dl">
               <a class="btn" data-download href="https://github.com/timbermods/MixedStorage/releases" rel="noopener"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3v12m0 0-4.5-4.5M12 15l4.5-4.5M4 20h16"/></svg><span class="btn-label">Download latest</span><span class="btn-size" data-size></span></a>
@@ -208,7 +208,7 @@ <h3><a href="https://timbermods.github.io/MixedStorage/">MixedStorage</a></h3>
             <h3><a href="https://timbermods.github.io/PersistentWorkAreas/">Persistent Work Areas</a></h3>
             <p class="tagline">Keep working-area outlines on screen.</p>
             <p class="blurb">Pin a farm, forester or gatherer's working area and its outline stays after you deselect it. Pick a crop or tree and the buildings that plant it are outlined too.</p>
-            <ul class="facts"><li>Overlapping pins merge into one outline</li><li>Clear pinned areas in one click, or with a key</li><li>Display only: saves untouched, pins local to each player</li></ul>
+            <ul class="facts"><li>Overlapping pins merge into one outline</li><li>Clear every pin in one click, or with a key you assign</li><li>Display only: saves untouched, pins local to each player</li></ul>
             <p class="status-line">Played extensively in game, planting-tool outlines and remembered pins included.</p>
             <p class="req"><span>Requires</span> Nothing extra</p>
             <div class="dl">
@@ -225,8 +225,8 @@ <h3><a href="https://timbermods.github.io/PersistentWorkAreas/">Persistent Work
             <div class="meta"><span class="pill tag">Building</span><span class="pill status" data-status hidden></span></div>
             <h3><a href="https://timbermods.github.io/timberborn-tipsy-tail/">The Tipsy Tail</a></h3>
             <p class="tagline">A swim-up pool bar for your beavers.</p>
-            <p class="blurb">A timber-and-thatch pool bar for eight beavers at once: a Social Life need of its own worth up to +2 well-being, plus Wet fur relief like the Lido. Haulers keep it filled with water.</p>
-            <ul class="facts"><li>A 5 × 6 site on solid ground, recessed into it</li><li>Runs on hauled water and stops when it runs dry</li><li>Folktails and Iron Teeth, under Well-being</li></ul>
+            <p class="blurb">A timber-and-thatch pool bar for eight beavers at once. It meets a Social Life need of its own, worth up to +2 well-being, and Wet fur like the Lido.</p>
+            <ul class="facts"><li>A 5 × 6 site on level ground, sunk two blocks into the soil</li><li>Runs on hauled water and stops when it runs dry</li><li>Folktails and Iron Teeth, under Well-being</li></ul>
             <p class="req"><span>Requires</span> Nothing extra</p>
             <div class="dl">
               <a class="btn" data-download href="https://github.com/timbermods/timberborn-tipsy-tail/releases" rel="noopener"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3v12m0 0-4.5-4.5M12 15l4.5-4.5M4 20h16"/></svg><span class="btn-label">Download latest</span><span class="btn-size" data-size></span></a>
@@ -248,12 +248,12 @@ <h2 id="install-title">Installing any of these</h2>
           <li>
             <span class="step-n" aria-hidden="true">1</span>
             <h3>Download the ZIP</h3>
-            <p>Use the download button under the mod. If you grab it from GitHub yourself, pick the ZIP under <em>Assets</em>, not <em>Source code</em>.</p>
+            <p>Use the mod's <em>Download latest</em> button. On GitHub, pick the ZIP under <em>Assets</em>, not <em>Source code</em>.</p>
           </li>
           <li>
             <span class="step-n" aria-hidden="true">2</span>
             <h3>Extract it into Mods</h3>
-            <p>With Timberborn closed, extract the mod's folder into <code>Documents\Timberborn\Mods</code>. Avoid an extra nested folder.</p>
+            <p>Close Timberborn. Extract the mod's folder into <code>Documents\Timberborn\Mods</code>, with no extra folder in between.</p>
           </li>
           <li>
             <span class="step-n" aria-hidden="true">3</span>
@@ -262,9 +262,9 @@ <h3>Enable it in the game</h3>
           </li>
         </ol>
         <div class="notes">
-          <div><h3>Harmony and Mod Settings</h3><p>These are separate mods from the Steam Workshop. Each mod above says which ones it needs.</p></div>
+          <div><h3>Harmony and Mod Settings</h3><p>Both are separate mods: subscribe to them on the Steam Workshop.</p></div>
           <div><h3>Playing co-op</h3><p>Every player installs the same version of the mod and runs the same game version.</p></div>
-          <div><h3>Beta and preview builds</h3><p>Builds marked <em>Beta</em> or <em>Preview</em> are early. Try them on a copy of a save, and report problems on the GitHub issues page.</p></div>
+          <div><h3>Beta and preview builds</h3><p>Builds marked <em>Beta</em> or <em>Preview</em> are early. Play them on a copy of a save, and report problems on the mod's GitHub issues page.</p></div>
         </div>
       </div>
     </section>