# Brentwood client guides — test findings

Newest session first.

---

## Verification pass: 2026-07-26 (Claude) — four findings corrected

The 2026-07-24 pass was done through the UI only. These items were re-checked against WordPress
7.0.2's own source and the theme code. Four conclusions change, two of them materially.

| # | Original verdict | What the code says |
|---|---|---|
| 1 | **blocker** — Staff/Careers have no Page Attributes box, so the Order instruction is unactionable | **Symptom real, cause wrong, scope bigger.** Both types *do* support `page-attributes` (`staff`, `bw_career`, `bw_hundred` all YES). What changed is WordPress: in 7.0 `AttributesPanel` renders **only** the Parent row, and **Order moved out of the sidebar into a post action** (`reorderPage`, id `order-pages`, label **"Order"**, opens a modal). So the instruction is wrong for **every** content type — Pages included — not just Staff and Careers. Fix: point all of them at the **Order** action, don't delete the capability. |
| 17 | **gap** — no way to duplicate a page; consider adding a duplicate-post plugin | **Original finding stands.** (An earlier version of this row claimed it was built in — that was wrong, corrected here.) WP 7.0 does ship a `duplicatePost` action, but it belongs to the **DataViews** screens, which need a block theme. This site runs Kadence, a classic theme: `wp_is_block_theme()` is false, so there's no Site Editor page list, and the classic Pages row actions are only **Edit · Quick Edit · Move to Trash · Preview** — verified on screen. There is no Duplicate anywhere. What *does* work, with no plugin: the editor's **⋮ → Copy all blocks**, then paste into a new page (Page Settings and the hero are not carried across and must be re-set). Documented that way in guide 24. |
| 7 | **major** — guide claims there's no SEO menu, but Yoast is plainly in the sidebar | **False positive — tested as an administrator.** `inc/bw-roles.php` already strips Yoast's top-level menu (and admin-bar node) from anyone without `wpseo_manage_options`, and hides `wpseo_meta` below Editor. The guide is correct for the roles it's written for. Worth one clause: "(administrators also see a Yoast SEO menu — you don't need it.)" |
| 10 | **major** — Hero Card greyed out in the inserter | **Confirmed, mechanism identified.** `default_content` in `inc/brentwood-blocks.php:786` puts a `brentwood/hero-card` into every brand-new **page**, and the block registers `supports.multiple: false`. Suggested wording stands. |

Also confirmed as reported: **#8** the button really is labelled **"View"**; **#5** there are **9** assignable
roles against 7 documented (Administrator is correctly not offered).

**Consequence for the fix list:** item 2 is not "delete the paragraph" but "re-point it at the Order
action, everywhere"; item 10's duplicate-a-page guide is a short write-up rather than a plugin
install; and the SEO rewrite is a one-clause caveat, not a correction.

---

## Session: 2026-07-24 — first full pass (Claude, fresh-eyes tester)

**Method.** Worked as a Brentwood staff member using only the in-admin **Guides** screen.
For each task: searched the Guides screen in plain language first, then followed the guide
literally on `brentwooddev`, and recorded every place the guide and the screen disagreed.
Theme/plugin code was not read to *answer* anything — only twice, afterwards, to confirm a
suspected inaccuracy (noted where that happened).

**Coverage.** All 26 guides read. Tasks attempted across all five groups (A–E); breadth
prioritised over depth per the brief. Test content created and then deleted (see Cleanup).

**Headline.** The guides are **substantially better than typical client documentation** — the
hard, confusable things are handled well (byline vs account, hero-type-first, Brentwood 100
shuffle, timetable letter counts, Careers having no page). The problems are concentrated in
three places: **(1) the search box**, **(2) menu/button labels drifting from the actual UI**,
and **(3) a handful of instructions pointing at controls that aren't on the screen.**

---

### Findings

Ordered blockers → major → minor. `screenshot: transcript` means the proof is in the session
transcript for this run rather than a file (the browser runs on the desktop, not the server, so
`save_to_disk` couldn't write into this repo).

| # | Task | Guide / section | Type | Severity | What happened | Suggested fix |
|---|---|---|---|---|---|---|
| 1 | 8, 11 (staff & job ordering) | *Managing staff profiles* → "Changing the order staff appear in"; *Posting jobs (Careers)* → "Changing the order postings appear in" | inaccuracy | **blocker** | Both guides say to "set an **Order** number in the **Page Attributes** box on the right". On the Staff and Careers edit screens there is **no Page Attributes box and no Order field** — the sidebar has only Status / Publish / Slug / Template / Parent. Verified by text-scanning the rendered page: `Page Attributes: absent, Order: absent`. The whole "hand-pick a sequence" instruction is unactionable. | Either expose the Order field (Screen Options / re-enable `page-attributes` in the sidebar) or delete the paragraph and document the real ordering control. For Staff, the Last Name method **does** work and is enough. |
| 2 | all searches (esp. 18) | Guides search box | search-miss | **major** | The box prompts "What do you need help with?" but matching is a strict **AND across every word**. "how do I write a news story for the school blog" → **"No guides found."** One word that appears nowhere (e.g. "story") kills the entire result set, with no fallback and no "did you mean". Short phrases work beautifully. | Fall back to OR/partial matching when the AND query returns nothing, and always show the closest sections. The "No guide matches this as a whole — the sections above are the closest answers" line already exists for some queries; make it the universal fallback instead of an empty state. |
| 3 | 18 (YouTube hero) | Guides search → *Page settings — titles, heroes and the footer image* | search-miss | **major** | This is the exact journey flagged as confusing. Searching "youtube video at the top of a page" returns **4 guide cards and no "Jump straight to"**, and the correct guide is **third**, below two block guides that look more relevant ("Adding images and video"). You only land right if you already know the word "hero" — "youtube hero" jumps straight to the correct H2. | Add "top of the page", "banner", "big image at the top", "video at the top" to the hero guide's KEYWORDS. Nothing wrong with the guide itself — it's excellent (see Strengths). |
| 4 | 1, 2, 7 (all custom fields) | *Writing & publishing blog posts* → "How do I write a new blog post?" / "…author name shown on a post?"; also every content-type guide | gap | **major** | Every custom box (Page Settings, Blog Details, Staff Details, Posting Details, Livestream Details, Brentwood 100 Details) lives inside a collapsible drawer labelled **"Meta Boxes"**, a term no guide uses. On a fresh **Posts → Add New** the drawer opened **covering the entire editor** — the title field and content area were not visible at all until I collapsed it. Step 2 says "Type the post title at the top"; there was no title on screen. The drawer state persists per user, so a client who collapses it loses Blog Details permanently with no idea why. | Add one short shared section — "The Meta Boxes drawer at the bottom" — to *Getting started* and cross-link it from every guide that says "in the … box below the content editor". Include the collapse/expand chevron and the drag handle. |
| 5 | 30 (choose a role) | *Managing users and roles* → "What can each role do?" | gap | **major** | The role table documents **7** roles. The Add User dropdown offers **10**: Blog Manager, Site Editor, Staff, **SEO Editor**, **SEO Manager**, Subscriber, **Contributor**, Author, Editor, Administrator. Task 30 asks you to decide "from the guide alone" — for three of the options the guide is silent. | Either add the three missing roles to the table (even just "SEO Editor / SEO Manager — not used at Brentwood; don't assign" and "Contributor — can draft but not publish"), or remove them from the dropdown. |
| 6 | 30 (add a user) | *Managing users and roles* → "How do I add a new user?" | unclear | **major** | The guide's 5 steps are: username, email, role, **Add New User**, "Tell them to sign in with their Brentwood Google account — **no password to set up**." The actual screen presents a **pre-filled, required, strong password** plus a ticked **"Send the new user an email about their account"** checkbox, and the button reads **Add User**. Neither the password nor the notification checkbox is mentioned, and "no password to set up" reads as contradicted by a big password field. | Add a step: "Ignore the password — leave the generated one. Leave *Send the new user an email* ticked (it tells them the account exists); they'll sign in with Google, not that password." Fix the button label. |
| 7 | 15 (page SEO) | *Managing page SEO* → intro | inaccuracy | **major** | The intro states: "there's **no separate SEO settings menu in the sidebar** for you to find, and that's intentional." **Yoast SEO is plainly in the left sidebar**, with a red "2" notification badge, on the account I used. If this is only hidden for some roles, the guide doesn't say so — and it undermines trust in the rest of the guide. | Reword to reflect reality, e.g. "You may see a *Yoast SEO* item in the sidebar — you don't need it. Everything for day-to-day editing is in the per-page box." Or hide the menu for the roles the guide is written for. |
| 8 | 37, 46 + every page edit | *How to Edit a Page* → "Editing a page, step by step" | inaccuracy | **major** | Step 3: "Click **Preview**, then **Preview in new tab**." The editor toolbar button is labelled **"View"** (confirmed from the button's accessible label). "Preview in new tab" *is* inside that menu, so step 3b is right — but the first click is named wrong, in the single most-used guide on the site. The screenshot caption ("Preview and Update, in the top right of the editor") carries the same stale word. | Change to "Click **View**, then **Preview in new tab**", and re-shoot the caption. |
| 9 | 21 (Table Link) | *Adding content blocks* → "How do I add a table or grid of links?" | inaccuracy | **major** | Guide: "click **Add link** for each link and fill its **Link text** and **Link URL**." The block's own sidebar says the opposite, explicitly: *"Edit the link text directly in the editor. Set each link's URL here."* Only the URL is in the sidebar; the visible text is typed into the block on the canvas. Following the guide literally, you hunt for a Link text field that isn't there. | "Click **Add link** for each link and set its **Link URL** here. Type the link's visible text directly on the block in the editor." |
| 10 | 21, 45 (Hero Card) | *Adding images and video* → "How do I add the white hero text card (Brentwood Hero Card)?" | unclear | **major** | Guide: "Add it as the first block on a page whose hero is switched on." In the inserter **Brentwood Hero Card is greyed out and un-clickable**. Reason (confirmed afterwards by inspecting the editor's block list): **a new Page already contains a `brentwood/hero-card` block**, and only one is allowed per page. So the instruction tells you to insert a block that is already there and cannot be inserted. Nothing explains the greyed state. | "Every new page already has a Hero Card as its first block — you don't add one. That's why it looks greyed out in the inserter. Just click into the existing card and add your content." |
| 11 | 22, 45 (Sub Page Link) | *Brentwood blocks at a glance* → "Blocks for text and layout" | inaccuracy | **major** | The one-line description reads "**Navigation cards pointing to the pages beneath this one**", which says *automatic*. The block is **entirely manual**: you hand-enter the parent Label and Link URL, then add each sibling tile with its own label, URL, uploaded image and alt text. (The fuller guide, *Adding content blocks*, describes it correctly — the two guides disagree.) | Reword the at-a-glance line: "Navigation cards you build by hand, linking to the other pages in this section." |
| 12 | 29 (Brentwood 100) | *Managing the Brentwood 100* → "What is the badge number?" | inaccuracy | **major** | Guide: "It's a label, **not a position control** — it doesn't decide where the tile sits." The field's own on-screen help says: "The centenary badge number shown on the tile (1–88, non-contiguous). **Also seeds the default order (menu_order).**" Both can be true (the grid shuffles on every visit), but a client reading the field help will conclude the guide is wrong. | Reconcile explicitly: "The number also sets the item's underlying sort order, but you won't see that on the site — the mosaic re-shuffles on every visit, so it has no visible effect on placement." |
| 13 | 34 (teacher self-edit) | *Updating your own staff profile* → "What do the fields mean?" vs *Managing staff profiles* | inaccuracy | **major** | The two guides use **different names for the same fields**. Admin side: **Title / Position**, **Departments**. Teacher side: **Titles & Departments**, **Categories**. A Marketing person walking a teacher through this by phone will not be able to follow. | Verify the real labels on `/my-profile` and make both guides use them; add "(called *Title / Position* in the admin)" where they genuinely differ. |
| 14 | 34 (`/my-profile`) | — (site issue, no guide covers it) | inaccuracy | **major** | `/my-profile` with an unlinked account shows: *"You don't have a profile linked to your account yet. Please contact marketing. **(Tip: open a staff member with `/my-profile/?staff_id=ID`.)**"* A developer debug hint is being shown to end users. The guide quotes only the first sentence. | Remove the Tip from the public-facing message (or show it only to administrators). |
| 15 | 24 (timetable) | — (site issue; the guide itself is accurate) | inaccuracy | **major** | The **"How this works"** panel at the top of the Timetable screen renders **raw Markdown**: `This page is **only for updating the text (copy) and images**…`, and a literal `— — —` rule. The site's own instructions look broken, which erodes confidence right before an anxious task. | Run that field through a Markdown/`wpautop` filter, or rewrite it as plain HTML. |
| 16 | 21 (block picking) | *Adding content blocks* → intro; *Adding images and video* → "How do I add one of these blocks to a page?" | gap | **major** | The inserter opens on a large **KADENCE BLOCKS** grid (Row Layout, Section, Accordion, Info Box…), which no guide mentions, and searching shows an **"Available to install"** section offering third-party plugin blocks from the WordPress directory (Cards Layout, Advanced Posts, Text Typing, "FAQ with search & filter" — all by bPlugins). A client looking for an FAQ block could easily install an unvetted plugin from inside the inserter. | Add a short warning to both block guides: "If you see an **Available to install** section, ignore it — never install a block from there. Everything you need is already on the site." Consider disabling block-directory search for non-admins. |
| 17 | 38 (duplicate a page) | none — no guide covers this | gap | **major** | Searching "duplicate" returns only "How do I add a link to a menu?" (duplicating a *link block*) and "Copying a block to another page". There is **no way documented to duplicate a page**, which is one of the most common real-world starting moves. | Either document the method that works on this site, or add a duplicate-post plugin and one H2: "How do I start a new page from an existing one?" |
| 18 | 39 (upload a PDF) | none — no guide covers this | gap | **major** | Searching "pdf" returns **no matching sections at all**. Uploading a newsletter/policy PDF and linking to it from a page is core school work and is entirely undocumented — including the non-obvious bits (Media Library upload, "Copy URL to clipboard", linking selected text). | Add an H2 to *Images and Media*: "How do I upload a PDF and link to it?" |
| 19 | 44 (YouTube inside a post) | none — search says so explicitly | gap | **major** | Searching "embed video" returns *Brentwood Video Text* and the livestream list block, then states: "**No guide matches this as a whole**". Putting an ordinary YouTube video into the body of a blog post (paste the URL / core Embed block) is not covered anywhere — and the two things that *do* come up are the wrong tools for it. | Add "How do I put a video inside a post?" to *Writing & publishing blog posts* (paste the link on its own line), and cross-reference it from *Adding images and video*. |
| 20 | 43 (new section page → menu) | *Editing the site menus* → intro | gap | **major** | The guide states up front that restructuring "isn't covered here". Creating a new section page, giving it a sub-nav strip, and getting it into a mega menu is achievable in pieces (Sub Nav box + Kadence → Navigations) but there is **no end-to-end recipe**, and this is a job a school does every year. | Add one worked example: "How do I add a whole new section page?" — create page → set parent → set *Sub nav for child pages* on the section top page → duplicate a link in the matching navigation. |
| 21 | 1 (categories) | *Writing & publishing blog posts* → "How do I put a post in a category?" | unclear | **major** | The guide says categories are "Athletics, Arts, Admissions and so on" and to "tick every category that applies". The real list is **150+ deeply nested terms**, mixing blog topics with what look like course/subject terms (Advanced Placement, Grade 10 Elective, Metamorphosis, Artscourse…). The guide never mentions the **Search Categories** box, and presents "+ Add New Category" as casual — with a list this size, duplicate categories are near-certain. | Mention the search box first ("type in *Search Categories* rather than scrolling"), and add a caution: "Check it doesn't already exist before adding a new one." Separately, the category list itself looks like it needs a tidy-up before launch. |
| 22 | 1, 3, 6, 9 | *Writing & publishing blog posts* → "How do I change a post's date?"; also the "Status & visibility" instruction in Staff / Careers / Livestreams / B100 / Landing guides | inaccuracy | minor | "In the settings sidebar, open the **Status & visibility** panel. Click the date shown next to **Publish**." A Status & visibility popover *does* exist (click the Status value) — but the **date is not in it**; it's a separate **Publish** row in the sidebar. Following the instruction literally, you open the popover and find Draft/Pending/Private/Scheduled/Published/Password and no date. | Drop the first step for the date task: "In the sidebar, click the date shown next to **Publish**." (The Status & visibility wording is correct for the draft/publish tasks.) |
| 23 | 3 (backdate) | *Writing & publishing blog posts* → "How do I change a post's date?" | inaccuracy | minor | "Pick the new date and time, **then confirm**." There is no Confirm button — the date applies as you pick it and you close the popover with × or by clicking away. | "Pick the new date and time, then close the little calendar." |
| 24 | 1 (categories) | same section | inaccuracy | minor | Guide says click "**+ Add New Category**", then "**Add New Category**" again. The actual link is **Add Category** (no plus, no "New"). | Match the label. |
| 25 | 7, 11, 12, 23, 29, 30 | Staff / Careers / Livestreams / B100 / Landing Pages / Users guides — all "how do I add…" sections | inaccuracy | minor | Systemic menu-label drift. Guide → actual: "Careers → **Add Posting**" → *Add New Posting*; "Livestreams → **Add New**" → *Add New Livestream*; "Brentwood 100 → **Add New**" → *Add New Item*; "Landing Pages → **Add New**" → *Add New Landing Page*; "Users → **Add New**" → *Add User*; button "**Add New User**" → *Add User*. (*Staff → Add New Staff Member* is correct.) | Sweep all guides against the live sidebar labels. Cheap to fix, and these are the very first step of each task. |
| 26 | 1 | *Writing & publishing blog posts* → "How do I write a new blog post?" | stale-shot | minor | The screenshot under this heading is dominated by the **Page Settings / Hero type** panel — hero focus sliders, zoom, height — with no title field or content area meaningfully visible. Its caption promises "The Blog Details box (with the Author field) sits below the content editor", but no Blog Details box appears in the shot. It illustrates the wrong thing for the step it sits above. | Re-shoot with the Meta Boxes drawer collapsed so the title + content + Featured image are the subject, and take a separate tight shot of the Blog Details box for the byline section. |
| 27 | 2 (byline) | *Writing & publishing blog posts* → "How do I set the author name shown on a post?" | unclear | minor | The guide's prose on this is genuinely excellent, but the screen gives no help: there are **two fields labelled "Author"** visible at once — the sidebar row (showing `support`) and the Blog Details field — with no descriptive text on either. | Not a guide fix — add help text to the ACF field: "The name shown on the post. Leave blank to use the publishing account's name." |
| 28 | 1 | *Writing & publishing blog posts* → step 4 | unclear | minor | "In the **Featured image** panel on the right, click **Set featured image**." Before an image is set the button does read *Set featured image*, but there is **no panel heading called "Featured image"** — it's an unlabelled button under the post title, and once set it becomes a bare thumbnail with Replace / Remove. | "Near the top of the **Post** tab on the right, click **Set featured image**." |
| 29 | 21 (Curve Divider) | *Adding content blocks* → "How do I add a curved divider beside an image?" | inaccuracy | minor | "The other options (**colour and size**) are fine-tuning you can usually leave alone." The block's sidebar has only **Curve → Side it bulges toward (Right/Left)**, plus **two panels both labelled "Advanced"** (a UI bug). No colour or size control is exposed. | Delete the colour/size clause. Separately, fix the duplicated *Advanced* panel on that block. |
| 30 | 21 (FAQ Accordion) | *Adding content blocks* → "How do I add a frequently-asked-questions section?" | gap | minor | The sidebar's first control is a **Layout style** dropdown ("Two-column (image + accordion)"), implying other layouts exist. The guide never mentions it and describes only the two-column form. | Document the Layout style options, or say "leave Layout style as it is." |
| 31 | 23 (landing pages) | *Building landing pages* → "What is a landing page…?" | inaccuracy | minor | "the same **Page Settings** box as a page". A landing page's Page Settings has **no *Override H1 page title*** field — Pages do. Everything else (Hero type, Footer image background) matches. | "…the same Page Settings box, minus the H1 title override." |
| 32 | 12 (livestreams) | *Managing livestreams* → "How do I add a livestream?" | unclear | minor | The **Livestream Details** box is real and complete, but it sits **below a full-height Yoast SEO panel** inside the Meta Boxes drawer — my first screenshot of the screen showed only Yoast. A client will think the box is missing. | "Scroll past the Yoast SEO box to find **Livestream Details**." (Or reorder the meta boxes so the content-type box is first — better fix, applies to every type.) |
| 33 | 20 (H1 override) | — (site issue; guide is correct) | inaccuracy | minor | The *Override H1 page title* help text renders as "Allowed HTML: **, , , .**" — the tag names have been stripped by the escaping. The guide correctly names `<em>` and `<strong>`; here the **guide is better than the UI**. | HTML-escape the allowed-tag list in the field description. |
| 34 | 18 (YouTube hero) | *Page settings…* → "How do I use a video or YouTube hero?" | gap | minor | For **Featured YouTube** the screen also offers a **Poster / cover image** ("overrides YouTube's default thumbnail"). The guide mentions Poster only under Featured Video. The field help also notes `youtu.be`, `/shorts` and a bare video ID all work — the guide says only "the full link". | Add the poster line to the YouTube bullet; mention that short links and bare IDs are accepted. |
| 35 | 8 (two-part surname) | *Managing staff profiles* → "How do I add a new staff member?" | gap | minor→major | The 7-step add-a-person list **never mentions First Name / Last Name**, yet the guide's own ordering section says sorting comes from the **Last Name** field. Anyone following the steps literally creates a profile with both name fields empty. | Add a step: "Fill in **First Name** and **Last Name** in the *Profile (self-service)* box — the site sorts staff by Last Name, so this matters for two-part surnames like *de la Cruz* or *van der Wal*." |
| 36 | — | *Managing staff profiles*; *Posting jobs (Careers)* | unclear | minor | Section headings are otherwise consistently phrased as the question a staff member would ask; "**Changing the order staff appear in**" and "**Changing the order postings appear in**" break that pattern, which hurts both scanning and search. | "How do I change the order staff appear in?" |
| 37 | 32 (create an Administrator) | *Managing users and roles* → "Why can't I create an Administrator?" | — | — | **Not a finding — reported for completeness.** The guide has a dedicated H2 that explains the restriction as a deliberate safety feature, in plain language, and it reads as intentional rather than broken. I did **not** empirically test it as a non-admin: doing so needs a second account and a second browser session, and the brief's "create one test user" allowance didn't justify logging out of the working session. Worth one manual check before launch. | — |
| 38 | 42 (seasonal jobs) | none | gap | minor | No guide frames a *job* that spans several screens — "refresh the faculty list after summer hiring", "roll the timetable to a new school year", "swap the homepage hero for a new campaign". Every ingredient is documented; the recipe isn't. | Consider one "Yearly jobs" guide that stitches existing sections together with links. Low urgency, high goodwill. |
| 39 | 46 (safety net) | *How to Edit a Page* → "Common questions" + REMEMBER | unclear | minor | Revisions/undo **is** covered — a REMEMBER box ("open **Revisions** on the Page tab and restore an earlier version", which matches the screen: my test page showed *Revisions 2*) and a collapsed question "I made a change and it looks wrong. Can I go back?". But it's inside an accordion in a guide titled *How to Edit a Page* — not where a worried person would look, and searching "undo" finds nothing. | Add "undo", "mistake", "revert", "I broke it" to KEYWORDS, and surface the safety net in *Getting started*. |
| 40 | search behaviour | Guides browse screen | unclear | minor | The "Jump straight to" list and the guide-card grid disagree. Searching **news** deep-links to two blog-guide H2s, yet the *Writing & publishing blog posts* **card is not in the grid below** — only *Getting Started with Your WordPress Admin* is. The two halves of the results page use different matching. | Make the card grid include any guide that produced a jump result. |
| 41 | 1 (write a post) | — (site issue) | unclear | minor | A large Yoast **"Stuck on what to write next? … Get content suggestions / Using 1 spark"** promo panel sits between the title and the first paragraph on every new post, unmentioned anywhere. It looks like part of the page and invites clicks that consume credits. | Hide the Yoast AI promo for editor roles. |

---

### What worked — and is worth protecting

These landed cleanly and should not be disturbed by any rewrite:

- **Deep links.** "Jump straight to" anchors take you to the exact H2. Once a search matches, the
  experience is genuinely excellent, and better than most commercial docs.
- **Byline vs account (task 2).** The single most confusable feature on the site, and the guide
  nails it — including *why* you'd use it ("a Blog Manager can publish for a student … without
  giving them a login") and the trap that the Blog block's Author filter matches the *account*,
  not the byline. This is the best-written section in the set.
- **Hero type must be chosen first (task 18).** Handled twice — in the hero table intro ("That one
  choice decides what shows; the matching settings appear just below it") and again inside the
  video section ("**first** set Hero type to the video option you want"). Verified: switching to
  Featured Gallery swaps the whole panel to Hero images + Gallery columns; Featured YouTube
  reveals a **YouTube URL** field. Landing mid-guide via a deep link still works.
- **Careers have no page of their own.** Stated in the intro *and* repeated as a NOTE under the
  add-a-job steps. Exactly right for something this counter-intuitive.
- **Brentwood 100 shuffle + badge number.** Both subtleties addressed head-on ("that's intentional,
  not a fault").
- **Timetable rotation letter count.** The IMPORTANT note ("each period row needs exactly as many
  letters as there are lines in Day Columns") is validated by the live data — 8 day columns,
  `A, D, C, F, B, E, A, D` = 8 letters.
- **Landing pages.** Both flagged subtleties correct and verified: a new landing page is genuinely
  **empty** while a new Page ships with a hero-card block, and its hero really does default to
  **Off — no hero**.
- **Staff ordering from Last Name**, and the `Connect User Account` → `/my-profile` flow — field
  names and help text match the screen exactly.
- **"Brentwood blocks at a glance"** (task 22/45) is the standout new guide. Its claims check out:
  every custom block is named `Brentwood …`, the icons really are red, typing "Brentwood" reveals
  all 25, and "Where do heroes come from?" pre-empts the commonest wrong search. This is the right
  answer to "I inherited a page and don't know what this block is."
- **Honesty.** The forms guide flags that *Admissions Inquiries (migrated)* has **no notification
  set up — nobody is emailed**. Documentation that admits a live gap is worth a great deal.
- **Field-name accuracy** in Testimonial, Video Text, Careers, Brentwood 100 and Timetable is
  essentially perfect — labels match the screen word for word.

---

### Top 10 fixes, in priority order

1. **Fix the search fallback.** Any full-sentence question currently returns an empty state. Fall
   back to partial matching plus "closest sections". This one change fixes the most journeys.
2. **Delete or repair the Page Attributes / Order instructions** in *Staff* and *Careers* — they
   point at a field that does not exist on those screens.
3. **Explain the "Meta Boxes" drawer** once, in *Getting started*, and cross-link it. Every custom
   field on the site is inside it, and it can hide the entire editor.
4. **"Preview" → "View"** in *How to Edit a Page* (plus the screenshot caption). Most-used guide,
   wrong on its third step.
5. **Users guide: document the missing three roles, and the password + notification fields.**
   Task 30 is currently unanswerable from the guide alone.
6. **Reconcile "there's no SEO menu in the sidebar"** — there is one, in plain sight.
7. **Hero Card: say it's already on the page and that's why it's greyed out.** Currently reads as
   a broken instruction.
8. **Table Link: correct where the link text is typed** (in the editor, not the sidebar) — the
   block's own help text contradicts the guide.
9. **Sweep every "Add New" against the real sidebar labels** (*Add New Posting*, *Add New Item*,
   *Add New Livestream*, *Add New Landing Page*, *Add User*). Trivial edits, first step of each task.
10. **Write the three missing guides:** duplicate a page · upload and link a PDF · put a YouTube
    video inside a blog post. All three are everyday school jobs with no coverage at all.

**Site fixes that aren't guide fixes** (worth doing before launch, in roughly this order):
the Timetable "How this works" box rendering raw Markdown · the `/my-profile` message leaking
`?staff_id=ID` to end users · the *Override H1* allowed-HTML list rendering as ", , , ." ·
the duplicated *Advanced* panel on Curve Divider · the Yoast AI promo panel inside the post
editor · block-directory "Available to install" results being offered to content editors ·
the 150+ term blog Categories list.

---

### Guide-by-guide verdict

| Guide | Verdict |
|---|---|
| Brentwood blocks at a glance | **Excellent.** Best-in-set. One wording fix (Sub Page Link). |
| Page settings — titles, heroes, footer | **Excellent.** Handles the hardest concept well. Findable only if you know "hero". |
| Managing livestreams | **Excellent.** Accurate throughout; one scrolling note needed. |
| Managing the Brentwood 100 | **Very good.** Fix the badge-number contradiction. |
| Editing the timetable | **Very good.** Guide is right; the screen it documents is what's broken. |
| Posting jobs (Careers) | **Very good** except the Order paragraph (blocker) and the menu label. |
| Building landing pages | **Very good.** One field-list correction. |
| Adding content blocks | **Very good.** Two field-level inaccuracies (Table Link, Curve Divider). |
| Adding images and video | **Very good** except the Hero Card section. |
| Writing & publishing blog posts | **Good.** Superb on the byline; weak on categories, the date steps and its lead screenshot. |
| Managing forms and inquiries | **Good.** Verified against the real menu; honest about the missing notification. |
| Managing staff profiles | **Good**, but two real problems: missing name fields, unactionable ordering. |
| Managing users and roles | **Needs work.** Incomplete role table, unexplained password step, wrong labels. |
| Managing page SEO | **Needs work** — one flatly incorrect claim in the intro, otherwise solid. |
| How to Edit a Page | **Needs work** — wrong button name in the core workflow. |
| Updating your own staff profile | **Needs work** — field names disagree with the admin-side guide. |
| Signing in | **Good.** Not fully testable without signing out; content is coherent and complete. |
| Editing the site menus | **Good, and appropriately cautious.** Missing the end-to-end "new section" recipe. |
| Fixing broken links with redirects | **Good.** Note there are *two* redirect tools in the sidebar (Tools → Redirection and Yoast Redirects); the guide names only Redirection — worth a one-line disambiguation. |

---

### Cleanup

Test content created during this session, all prefixed `TEST — ` and left as drafts, then deleted:

- `TEST — Guide Test Blog Post` (post) — byline, category, featured image, backdate, gallery hero
- `TEST — Marta de la Cruz` (staff) — two-part surname, position, credentials, department
- `TEST — Guide Test Page` (page) — six Brentwood blocks

Deleted permanently with `--force` (not left in Trash); deletion verified. No existing content,
users, forms, menus, settings, plugins or themes were changed. No forms were submitted. No test
user was created (see finding 37) — the Add User form was opened to inspect it and abandoned.

Opening an "Add New" screen makes WordPress create an empty `auto-draft`, so a few of those
remain from this session. They are invisible on the site and WordPress purges them automatically
after 7 days, so they were left alone.

**Unrelated observation worth a look:** the `auto-draft` table shows bursts of empty `page`
auto-drafts being created every ~20 seconds in runs of a dozen or more (e.g. 15:17–15:20 and
15:40–15:43 on 2026-07-24) that don't correspond to anyone opening an editor. Something automated
is creating them. Harmless but noisy — worth identifying before launch.