# ⛔ These drafts are NOT the source of truth for guide content

**The published guides on the hub are.** Edit guides at
<https://plugins.bowden.works/wp-admin/edit.php?post_type=bw_guide>.

**Do NOT rebuild guide content from these files.** Doing so would overwrite live,
corrected content with an older version.

---

## Why this changed

These drafts existed to author 20 Brentwood guides in bulk, with screenshot markers. That
job is finished. Since then the guides have been corrected directly on the hub — a
test-drive pass on 2026-07-26 fixed real problems in them.

Measured on 2026-07-26 before this file was written: **13 of 20 guides had drifted, and the
hub was ahead in every case.** A rebuild-from-drafts would have destroyed, among others:

- whole sections that exist only on the hub ("How do I put a video inside a post?", "How do
  I upload a PDF and link to it?", "What is the Meta Boxes drawer…")
- corrected instructions (reordering staff via **Quick Edit**, not Page Attributes)
- an added Contributor row in the roles table
- numerous clarifications (which Yoast panels to ignore, that a page can only have one Hero
  Card, that signing in with Google is what grants access)

Guide 05 (`brentwood-100`) had been substantially rewritten on the hub — the draft is
~3,000 characters of stale text.

Nobody did anything wrong. Two sources of truth existed, and the newer edits landed in the
one people naturally reach for. That ambiguity is what this file removes.

## What these files ARE still for

**The screenshot capture manifest.** The `BWG-SHOT` markers and `_frag/*.shots.md` entries
hold the working capture recipes — paths, regions, selectors, `actions="…"` interaction
scripts including the timings that took real effort to find. Those remain valuable for
re-shooting, e.g. after the `guide-shots` fixture is upgraded to WordPress 7.0.2.

`tools/bw-guide-shot/check-shots.py` validates this directory in that role: that every
declared shot has exactly one marker, every marker has a PNG, and no PNG is orphaned. That
check remains meaningful and should keep passing.

**Treat the guide bodies here as a historical record of how each guide was first written,
not as its current text.**

## If you need to re-shoot a screenshot

1. Read the recipe from the marker / fragment here.
2. Capture with `tools/bw-guide-shot.sh` (see its README — note `--reset-ui`, `--clip`, and
   the layout-shift race).
3. Import to the hub media library and place the image **directly in the hub guide's
   content**, the same way the standard guides work. Do not round-trip through these files.

## If you genuinely need to change guide text

Edit it on the hub. That's it. There is no longer a second place to update.