How to start writing WordPress tutorials

Here’s how to start writing WordPress tutorials, in four easy steps:

  1. Toy with the idea. Write two of them. Forget all about it.
  2. Wait seven years.
  3. Register a post type for the tutorials in your development environment, and discover the two tutorials from 2019 already in the database. Be glad they’re badly out of date. Seven years of WordPress development should count for something.
  4. Rewrite them, and keep adding more.

There are now 19 tutorials in the new WordPress tutorials section, from the basics to block themes – and, as of last week, AI. You can’t escape it.

I try to keep the tutorials short and focused on a single subject, like adding custom icons to a block theme, adding a variable font in theme.json or hiding a block on mobile. Every tutorial is tagged with the version of WordPress it was last tested with.

Going forward, most of them will be about block themes. It’s what I’m most interested in, and it gives me somewhere to point people who reach out to me for help with my themes. Writing them is also a way for me to keep up with what’s happening in WordPress, and to learn about features I might not come across otherwise. Most recently, I’ve done a deep dive into the AI features in WordPress 7.0 and 7.1:

Missing a tutorial? Let me know what you’d like to learn, and I might write it.

Get new posts in your inbox