What happens to tutorials when WordPress renames a feature? WPwatercooler 457

WPwatercooler episode 457 thumbnail: A Reusable Block by Any Other Name, with a red block icon

What happens to every tutorial when WordPress renames a feature? In mid 2023, reusable blocks became synced patterns, and WPwatercooler episode 457 talked through what that rename costs the people who teach WordPress. I joined the panel, fresh from WordCamp Montclair.

🎙️ Episode details

Captions and an interactive transcript are in the player controls (Transcript button).

The captions are YouTube’s automatic captions, cleaned for repeated lines and names but not checked against the audio.

🎙️ WordCamp Montclair’s broadcast setup

WordCamp Montclair takes place on a college campus with a journalism school, and broadcast students need recording hours. So the camp had production quality gear recording the sessions.

📚 Who updates the training when reusable blocks get a new name?

One of the hosts pointed out that a rename leaves teaching material wrong the day a release ships, and credited me with much of the release documentation for Training. However, I clarified my part: I find what needs to change in Learn WordPress for each release, rather than writing all the new content myself.

I also added that the Docs and Training teams were working with locale ambassadors so translated materials keep up too, and I pointed listeners to the release’s call for testing, where the Test team wants detailed feedback.

🧪 What can you take from the reusable blocks rename?

  • Educators and authors: audit your materials against each release’s terminology changes.
  • Testers: answer the call for testing before a release, while names can still change.

Also, more conversations like this one live in my podcast and speaking archive.

🗓️ Archival note

This episode streamed live on June 30, 2023, per the YouTube listing. Then I added this post on November 9, 2026, from the YouTube description and automatic captions, which have no speaker names. I attributed only statements whose speaker is clear from the conversation, and I didn’t rewatch the stream.

FIELD NOTES

Get the next field note in your inbox

A weekly note from the open-source frontier — what I’m building, breaking, and learning. No spam, no AI summaries, real writing from a real human.

Your post must include a link to this post.

How does this work?
Write a response on your own website and include a link to this post. Then submit your response’s URL here. Your response may appear here after moderation. To update or remove it, edit or delete your original post and submit the same URL again. Learn more about Webmentions.